Open
Description
Schema Inaccuracy
GitHub REST API uses OAuth2 access tokens, and has some support for query string tokens (deprecated) and basic auth (hmmmm) which could be described in your OpenAPI.
- GitHub REST API: Authentication
- Swagger.io Authentication Tutorial
- Avoid figuring out YAML syntax for security schemas with Stoplight Studio
Expected
components:
securitySchemes:
BasicAuth:
type: http
scheme: basic
OAuth2:
type: oauth2
flows:
authorizationCode:
authorizationUrl: https://example.com/oauth/authorize
tokenUrl: https://example.com/oauth/token
scopes:
read: Grants read access
write: Grants write access
admin: Grants access to admin operations
Also this gave me the idea to make security schemes in OpenAPI, deprecateable thank you! OAI/OpenAPI-Specification#2506