- Notifications
You must be signed in to change notification settings - Fork9.2k
OAI OpenAPI-Specification Discussions
Categories, most helpful, and community links
Categories
Uh oh!
There was an error while loading.Please reload this page.
Community links
Discussions
You must be logged in to vote You must be logged in to vote You must be logged in to vote You must be logged in to vote You must be logged in to vote You must be logged in to vote You must be logged in to vote Definition of a breaking change
OAI-scope versioningdescribing versions of APIs/endpoints/operations You must be logged in to vote You must be logged in to vote 3.3: allow
metadataopenapifield to just specify MAJOR.MINOR and omit the PATCH numbertags, info, license, contact, markdown usage, etc. You must be logged in to vote You must be logged in to vote Clarification on Best Practices for Extending OpenAPI Specification
Process registriesRelated to any or all spec.openapis.org-hosted registries You must be logged in to vote API specification format for hypermedia-centric APIs
schema-object media and encodingIssues regarding media type support and how to encode data (outside of query/path params) You must be logged in to vote You must be logged in to vote Response Object with optional empty response via content negotiation.
httpSupporting HTTP features and interactions You must be logged in to vote Are there plans to add support for global responses?
re-use: globals/defaultsDefault or global components that can be overridden in some way You must be logged in to vote Represent XML tag with multiple namespaces
xml media and encodingIssues regarding media type support and how to encode data (outside of query/path params) You must be logged in to vote Content type sniffing priority (3.3+)
OAI-scope httpSupporting HTTP features and interactions registriesRelated to any or all spec.openapis.org-hosted registries You must be logged in to vote Proposal for OpenAPI Extension: x-sensitive-data
registriesRelated to any or all spec.openapis.org-hosted registries You must be logged in to vote Security Schema, env/server dependent
security security: configThe mechanics of severs and structure of security-related objects You must be logged in to vote Security: Add optional client_id attribute to OAuth2
security security: authAuthentication including overlap with authorization You must be logged in to vote Schema test coverage: which thresholds are useful?
Schemachanges related to the schema(s) You must be logged in to vote provide API versions history
versioningdescribing versions of APIs/endpoints/operations You must be logged in to vote Support oauth 2.0 token exchange (RFC 8693)
security security: authAuthentication including overlap with authorization You must be logged in to vote Formalize Webhooks Subscribe/Unsubscribe
question httpSupporting HTTP features and interactions webhooksYou must be logged in to vote Add example(s) to securitySchemes:
security example obj/keywordsIssues with the Example Object or exampel(s) keywords security: configThe mechanics of severs and structure of security-related objects