openapi: 3.0.1
info:
  title: Example

servers:
- url: https://api.example.com/myapi
paths:
  /people/search:
    post:
      tags:
      - People
      summary: Get People
      description: Description about this endpoint
      operationId: GetPeople
      requestBody:
        description: JSON body with parameters
        required: true
        content:
          'application/json':
            schema:
              $ref: '#/components/schemas/json_body'

components:
  schemas:
    json_body:
      title: JSON body
      type: object
      properties:
        param1:
          type: object
          properties: {}
          description: Description about param1
        param2:
          type: object
          properties: {}
          description: Description about param2

  securitySchemes:
    api_key:
      type: http
      description: API key to authorize requests
      name: api_key
      in: query

    client_id:
      type: http
      description: Client id to authorize requests
      name: client_id
      in: query

security:
  - api_key: []
    client_id: []