swagger.io
swagger.io copied to clipboard
swagger-api
The content of swagger.io
The current link to Apache License 2.0 towards the top of https://swagger.io/specification/ is currently this: ## https://www.apache.org/licenses/-l-i-c-e-n-s-e-2.0.html But this is a dead link and returns a 404; the correct link...
Using a new (vanilla) `editor.swagger.io` template and adding _Basic Authentication_ from the [doc](https://swagger.io/docs/specification/authentication/basic-authentication/) does not result in CURL actually sending `-u "username:password"`. (It's also unclear how enter a Base64 value...
I believe that there are a few syntax issues (mainly indentations) with the example provided [here](https://swagger.io/docs/specification/callbacks/) and that the complete example should be: ```yaml openapi: 3.0.0 info: version: 0.0.0 title:...
Screenshot 
The example under the 'Model Composition' section is 'Inheritance and Polymorphism' has the wrong indentation on this page: [https://swagger.io/docs/specification/data-models/inheritance-and-polymorphism/](https://swagger.io/docs/specification/data-models/inheritance-and-polymorphism/) This can be confusing since there is no verbal explanation at...
The documentation that describes the **oneOf** keyword has wrong examples in it. The specification looks like this: ```paths: /pets: patch: requestBody: content: application/json: schema: oneOf: - $ref: '#/components/schemas/Cat' - $ref:...
I am referring this url - https://swagger.io/docs/specification/callbacks/, where the section called Multiple Callbacks suppose to define 3 callback events but it currently defined just one call back event named -...
There is an error at https://swagger.io/docs/specification/serialization/#path -- the example for style=label, explode=false, type=array is `/users/.3,4,5` when it should be `/users/.3.4.5`, and type=object is `/users/.role,admin,firstName,Alex` but should be `/users/.role.admin.firstName.Alex`. e.g. compare...
I believe there is an error in https://swagger.io/docs/specification/serialization/#query, when describing the `spaceDelimited` and `pipeDelimited` styles: in the explode=true case, it gives a serialized string `/users?id=3&id=4&id=5`, but actually should say `n/a`,...
Hi, I'm using _io.swagger_ annotation version 1.6.1. However I catch a error _java.lang.NumberFormatException: For input string: "null" at java.lang.NumberFormatException.forInputString(NumberFormatException.java:76)_. Could you help me? ``` io.swagger swagger-annotations 1.6.1 provided ``` Error:...
