When I try to the "content" under "responses" I get the error:
responses['200'] should NOT have additional properties additionalProperty: content, description
Even though I copied the code straight out of the Swagger example:
responses: 200: description: "Got form" content: application/json: schema: type: object properties: id: type: integer description: The user ID.
It doesn't like the content field, what am I doing wrong?
Go to Solution.
Is your spec in the OpenAPI 3.0 or Swagger 2.0 format?
If you use OpenAPI 3.0, add quotes around "200" and make sure description and content have the indentation.
If it's Swagger 2.0, use the following instead. See Describing Responses for more examples.
description: "Got form"
description: The user ID.
View solution in original post
Is there a good example of the 3.0?When I switch my doc to point to 3.0 I get this:
Schema error at swagger
should be equal to one of the allowed values allowedValues: 2.0
3.0 specs use
We have a 3.0 syntax guide here:https://swagger.io/docs/specification/basic-structure/and the response syntax guide:https://swagger.io/docs/specification/describing-responses/
Hope this helps!