swagger.io
swagger.io copied to clipboard
swagger-api
The content of swagger.io
On https://swagger.io/docs/specification/using-ref/#escape, there's a section that says: ``` For example, to refer to the path /blogs/{blog_id}/new~posts, you would use: $ref: '#/paths/~1blogs~1{blog_id}~1new~0posts' ``` The `/` and `~` are encoded to `~1`...
In the example with the `next` cursor value `Q1MjAwNz` (on the Links page at https://swagger.io/docs/specification/links/), the `limit` value supplied in the query string is `100`, but the `count` returned under...
# The Issue The [describing responses](https://swagger.io/docs/specification/describing-responses/) section of the specification documentation states: > Note that, currently, OpenAPI Specification does not permit to define common response headers for different response codes...
Reading [documentation here](https://swagger.io/docs/specification/callbacks/). I think that in the multiple callbacks section, the example is missing event names for `failedUrl` and `successUrl` cases. So instead of: ``` callbacks: inProgress: '{$request.body#/inProgressUrl}': post:...
SSNs cannot begin with the number 9 (that signifies an ITIN, not an SSN). Also, prefixes like 666 and 333 are also not valid. Meaning the following regex does not...
Chrome Version 88.0.4324.146 (Official Build) (x86_64) on macOS Visit https://swagger.io/docs/specification/data-models/data-types/ See lots of text where sections don't stand out and are almost not recognized as things. It's really hard to...
https://swagger.io/docs/specification/paths-and-operations/ under "Query String in Paths" mentions: > This also means that it is impossible to have multiple paths that differ only in query string, such as: ``` GET /users?firstName=value&lastName=value...
https://swagger.io/docs/specification/describing-parameters/ check under "Header Parameters" and the table, where it says "Accept". It says it is part of `responses..content.` and the link in the last column also links to response....
 FF v82.0
Welcome to [WhiteSource for GitHub.com](https://github.com/apps/whitesource-for-github-com)! This is an onboarding PR to help you understand and configure settings before WhiteSource starts scanning your repository for security vulnerabilities. :vertical_traffic_light: WhiteSource for GitHub.com...
![mend-for-github-com[bot] avatar](https://avatars.githubusercontent.com/in/30796?v=4 "mend-for-github-com[bot] avatar"){kind=avatar}