Forum Discussion

ppazos's avatar
ppazos
New Contributor
6 years ago

Problems adding two examples for a response

Hi, I have an endpoint that can return a response based on two different schemas, which I have on the response with oneOf.   I'm trying to add examples of those two payloads to the response of th...
  • HKosova's avatar
    HKosova
    6 years ago

    "example" (singular) expects a single inline example, so this definition

    example:
      - ex1
     ....
  - ex2
      .....

    means that the example value is literally

      - ex1
     ....
  - ex2
      .....

     

    The syntax with multiple "examples" would look like this:

          responses:
        '200':
          description: OK
          content:
            application/json: 
              schema:
                oneOf:
                  - $ref: '#/components/schemas/A'
                  - $ref: '#/components/schemas/B'
              examples:
                cat:
                  summary: An example of a cat
                  value:
                    name: Fluffy
                    petType: Cat
                    color: White
                    gender: male
                    breed: Persian
                dog:
                  summary: An example of a dog with a cat's name
                  value:
                    name: Puma
                    petType: Dog
                    color: Black
                    gender: female
                    breed: Mixed

     

ppazos's avatar
ppazos
New Contributor
6 years ago

In fact with "example" and specifying a list, the yaml validates.

 

example:
  - ex1
     ....
  - ex2
      .....

With "examples" that doesn't validate. In the first item of th list I get "should be an object".

Can you share a valid code with more than one example for the response?

Thanks.

 

 

 

  • HKosova's avatar
    HKosova
    SmartBear Alumni (Retired)
    6 years ago

    "example" (singular) expects a single inline example, so this definition

    example:
      - ex1
     ....
  - ex2
      .....

    means that the example value is literally

      - ex1
     ....
  - ex2
      .....

     

    The syntax with multiple "examples" would look like this:

          responses:
        '200':
          description: OK
          content:
            application/json: 
              schema:
                oneOf:
                  - $ref: '#/components/schemas/A'
                  - $ref: '#/components/schemas/B'
              examples:
                cat:
                  summary: An example of a cat
                  value:
                    name: Fluffy
                    petType: Cat
                    color: White
                    gender: male
                    breed: Persian
                dog:
                  summary: An example of a dog with a cat's name
                  value:
                    name: Puma
                    petType: Dog
                    color: Black
                    gender: female
                    breed: Mixed