openapi.yaml

openapi: '3.0.3'
info:
  version: "1.0.0"
  title: Sample API
servers:
  - url: http://localhost:8080/v2
paths:
  /people:
    get:
      tags:
        - People
      description: |
        Gets `Person` objects.
        Optional query param of **size** determines
      parameters:
        - name: size
          in: query
          description: Size of array
          required: true
          schema:
            type: integer
            format: int32
      responses:
        # Response code
        200:
          description: Successful response
          content:
            'application/json':
              schema:
                type: array
                items:
                  $ref: '#/components/schemas/Person'

components:
  schemas:
    Person:
      type: object
      properties:
        firstname:
          type: string
        lastname:
          type: string
        single:
          type: boolean