open api spec samples

oneof.yaml

openapi: "3.0.0"
info:
  version: 1.0.0
  title: Swagger Petstore
paths:
  /pets:
    get:
      summary: List all pets
      operationId: listPets
      tags:
        - pets
      parameters:
        - name: limit
          in: query
          description: How many items to return at one time (max 100)
          required: false
          schema:
            type: integer
            format: int32
      responses:
        '200':
          description: A paged array of pets
          content:
            application/json:    
              schema:
                $ref: "#/components/schemas/Pets"
    post:
      summary: Create a pet
      operationId: createPets
      tags:
        - pets
      responses:
        '201':
          description: Null response
  
components:
  schemas:
    Pet:
      oneOf:
      - $ref: '#/components/schemas/Cat'
      - $ref: '#/components/schemas/Dog'
      - $ref: '#/components/schemas/Lizard'
      discriminator:
        propertyName: petType
    Cat:
      required:
        - name  
      properties:
        name:
          type: string
        petType:
          type: string
    Dog:
      required:
        - name  
      properties:
        name:
          type: string
        petType:
          type: string
    Lizard:
      required:
        - name  
      properties:
        name:
          type: string
        petType:
          type: string

    
    Pets:
      type: array
      items:
        $ref: "#/components/schemas/Pet"