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