-
Notifications
You must be signed in to change notification settings - Fork 9.1k
Insights: OAI/OpenAPI-Specification
Overview
Could not load contribution data
Please try again later
51 Pull requests merged by 6 people
-
Port a few more fixes to 3.1.1
#3926 merged
Jun 23, 2024 -
format: byte also defaults to octet-stream (3.0.4)
#3922 merged
Jun 23, 2024 -
Authoritative rendering; "schema" usage (3.0.4)
#3927 merged
Jun 23, 2024 -
Reorganize and streamline form media type guidance (3.0.4)
#3923 merged
Jun 23, 2024 -
Port remaining 3.0.4 fixes with adjustments for 3.1.1
#3921 merged
Jun 21, 2024 -
3.0.4 dev: typo "paramter"
#3924 merged
Jun 20, 2024 -
Use document/description/definition consistently (3.0.4)
#3908 merged
Jun 20, 2024 -
Minor editiorial and link target fixes (3.0.4)
#3920 merged
Jun 19, 2024 -
OIDC fixes (3.2.0 port of #3607, #3718)
#3891 merged
Jun 19, 2024 -
More guidance on schema dialects.
#3909 merged
Jun 18, 2024 -
Consisent x- Param/Encoding/Header wording (3.0.4)
#3919 merged
Jun 18, 2024 -
Fix stray mentions of parameters in Encoding / Header Objects (3.0.4)
#3911 merged
Jun 17, 2024 -
Clarify discriminator non-impact on validation
#3907 merged
Jun 17, 2024 -
Resolving implicit connections (3.0.4 port of #3856)
#3906 merged
Jun 17, 2024 -
Fix XML namespace syntax
#3905 merged
Jun 16, 2024 -
Include Header Object in data serialization list
#3917 merged
Jun 16, 2024 -
Fix heading levels
#3904 merged
Jun 14, 2024 -
Appendix for percent-encoding concerns (3.0.4)
#3859 merged
Jun 13, 2024 -
Alternative: Clarify resolving implicit connections (3.1.1- alternative to #3823)
#3856 merged
Jun 13, 2024 -
Encoding Object content and header clarifications (3.0.4)
#3857 merged
Jun 12, 2024 -
Update ReSpec versions for Arazzo
#3900 merged
Jun 12, 2024 -
Various minor editorial improvements (3.0.4)
#3861 merged
Jun 11, 2024 -
Add Security Considerations (3.0.4)
#3894 merged
Jun 11, 2024 -
Warnings for header and cookie serialization (3.0.4)
#3841 merged
Jun 10, 2024 -
Appendix on converting data types to strings (3.0.4)
#3840 merged
Jun 10, 2024 -
Stub out appendix headers (3.1.1)
#3898 merged
Jun 10, 2024 -
Stub out all appendix headers (3.0.4)
#3897 merged
Jun 10, 2024 -
Appendix on RFC6570-derived behavior + `allowReserved` (3.0.4)
#3818 merged
Jun 10, 2024 -
Improve media type serialization examples (3.0.4)
#3864 merged
Jun 10, 2024 -
Verbose Header Object documentation (3.0.4)
#3867 merged
Jun 10, 2024 -
Bump yaml from 2.4.3 to 2.4.5
#3896 merged
Jun 10, 2024 -
Minor webhooks/callbacks and schema `examples` improvements (3.1.1)
#3862 merged
Jun 10, 2024 -
Resolution of relative URLs in CommonMark text (3.1.1 port of #3858)
#3892 merged
Jun 10, 2024 -
Consolidate guidance around examples (modified 3.1.1 port of #3893)
#3895 merged
Jun 10, 2024 -
Consolidate guidance around examples (3.0.4)
#3893 merged
Jun 9, 2024 -
Bump @hyperjump/json-schema from 1.9.2 to 1.9.3
#3889 merged
Jun 7, 2024 -
Clarify Link Obj parameters as best we can (3.2.0 port of #3824)
#3884 merged
Jun 6, 2024 -
Path Item $ref change warning (3.1.1)
#3860 merged
Jun 6, 2024 -
Resolution of relative URLs in CommonMark text (3.0.4)
#3858 merged
Jun 6, 2024 -
Clarify "URI" and "URL" meaning and usage (3.1.1)
#3838 merged
Jun 6, 2024 -
Clarify Link Obj parameters as best we can (3.1.1 port of #3824)
#3883 merged
Jun 6, 2024 -
Clarify discriminator + oneOf/anyOf/allOf usage (3.2.0 port of #3846)
#3885 merged
Jun 6, 2024 -
OpenID Connect Discovery URL fix (3.0.4 port of #3718)
#3882 merged
Jun 6, 2024 -
OpenID Connect Core URL fix (3.1.1 port of #3607)
#3881 merged
Jun 6, 2024 -
Backport (3.0.4) of merge resolution from #3846
#3880 merged
Jun 6, 2024 -
Add level2 headings to Security Considerations doc
#3871 merged
Jun 6, 2024 -
Clarify Link Obj parameters as best we can (3.0.4)
#3824 merged
Jun 4, 2024 -
Clarify discriminator + oneOf/anyOf/allOf usage (3.1.1 modified port of #3822)
#3846 merged
Jun 4, 2024 -
Bump yaml from 2.4.2 to 2.4.3
#3873 merged
Jun 3, 2024 -
Update ReSpec versions for Arazzo
#3851 merged
May 24, 2024 -
Update ReSpec versions
#3844 merged
May 23, 2024
6 Pull requests opened by 2 people
-
Move gh-pages into main branch
#3868 opened
May 31, 2024 -
Proposal: Bundled streams w/ self-identification
#3875 opened
Jun 3, 2024 -
Remove examples folder [main branch]
#3913 opened
Jun 15, 2024 -
Remove examples folder [v3.0.4-dev branch]
#3914 opened
Jun 15, 2024 -
Remove examples folder [v3.1.1-dev branch]
#3915 opened
Jun 15, 2024 -
Remove examples folder [v3.2.0-dev branch]
#3916 opened
Jun 15, 2024
129 Issues closed by 8 people
-
Example contains deprecated property
#3349 closed
Jun 21, 2024 -
Spelling: WebHook -> Webhook
#2503 closed
Jun 21, 2024 -
Clarify default dialect for referenced JSON Schema documents
#3877 closed
Jun 21, 2024 -
Mixed type array with array of objects in location path
#2276 closed
Jun 21, 2024 -
does the XML "namespace" field allow URI fragments?
#3263 closed
Jun 21, 2024 -
Add Security Considerations section
#2950 closed
Jun 21, 2024 -
Missing description for the Example Object
#2160 closed
Jun 21, 2024 -
Documentation for OpenAPI's Header Object should be verbose
#1965 closed
Jun 21, 2024 -
Provide guidance on Markdown table syntax
#1867 closed
Jun 21, 2024 -
XML Object - an incomprehensible sentence
#2106 closed
Jun 21, 2024 -
Add clarity around case sensitivity
#2785 closed
Jun 21, 2024 -
Example of deepObject + explode=false
#1322 closed
Jun 21, 2024 -
Add example before the specification
#2034 closed
Jun 21, 2024 -
should Cookie headers be ignored by 'parameters'?
#2819 closed
Jun 21, 2024 -
(De-)Serializing null, required, and empty values ins OAS parameters
#2037 closed
Jun 21, 2024 -
Consider using RFC3986 encode form-urlencoded
#1778 closed
Jun 21, 2024 -
[oas3] Default 'explode' for cookie parameters?
#1528 closed
Jun 21, 2024 -
Encoding object has style and contentType
#1551 closed
Jun 21, 2024 -
deepObject parameter style produces invalid URIs
#1942 closed
Jun 21, 2024 -
rfc6570 template clarification requested for the parameter styles, cookie use case unclear
#2940 closed
Jun 21, 2024 -
Doc improvements: query formats (n/a usage, "rendering")
#1663 closed
Jun 21, 2024 -
"body parameter" example in 3.x does not fit how Request Body Objects work
#3761 closed
Jun 21, 2024 -
Behaviour of pattern (regex) with url encoding
#2045 closed
Jun 21, 2024 -
How are conflicts between `allowReserved` and RFC 3986 handled?
#3759 closed
Jun 21, 2024 -
pipeDelimited and spaceDelimited style examples can be unresolvable
#3737 closed
Jun 21, 2024 -
Encoding Object `contentType` field: "comma-separated list of the two types"?
#3739 closed
Jun 21, 2024 -
Ambiguities Regarding Parameter Example Validation
#3041 closed
Jun 21, 2024 -
Can we get clarification on how to post multipart/form-data containing an array of items of type X?
#2840 closed
Jun 21, 2024 -
Unclear portion of openIdConnectUrl for openIdConnect securitySchema
#3152 closed
Jun 21, 2024 -
Open Community (TDC) Meeting, Thursday 06 June 2024
#3865 closed
Jun 20, 2024 -
Specify how relative URLs in rich text descriptions should be resolved
#1701 closed
Jun 19, 2024 -
OAS Dialect does not require the OAS vocabulary
#3901 closed
Jun 19, 2024 -
Clarify the meaning of info.version
#3872 closed
Jun 16, 2024 -
Extend V3 "examples" spec to include names (or IDs) and more data
#1265 closed
Jun 13, 2024 -
Open Community (TDC) Meeting, Thursday 30 May 2024
#3843 closed
Jun 13, 2024 -
Reusable media types
#2845 closed
Jun 12, 2024 -
Support XML simple type lists
#612 closed
Jun 9, 2024 -
Clarify parsing ambiguity of "parameters" in Link Object
#3276 closed
Jun 6, 2024 -
Problems in parameters field type for Link Object
#1143 closed
Jun 6, 2024 -
How to find discriminator targets
#3591 closed
Jun 6, 2024 -
Clarification on `discriminator` usage on `allOf` schemas.
#3424 closed
Jun 6, 2024 -
Discriminator: how properly detect valid reference
#2520 closed
Jun 6, 2024 -
Open Community (TDC) Meeting, Thursday 23 May 2024
#3811 closed
Jun 6, 2024 -
Inconsistent or unclear string format : byte or base64
#3886 closed
Jun 5, 2024 -
Mention registry in the section defining extensions
#3879 closed
Jun 4, 2024 -
OAUTH2 Password flow examples
#3098 closed
May 30, 2024 -
extension registry management
#1806 closed
May 30, 2024 -
Open Community (TDC) Meeting, Thursday 16 May 2024
#3794 closed
May 30, 2024 -
XML mapping for enum elements
#2497 closed
May 29, 2024 -
Internal references pointing out of the Components Object fixed fields
#2038 closed
May 27, 2024 -
Support for asciiDoc in the description attribute of the info and pathItem Object
#1884 closed
May 27, 2024 -
Clarify if JSON References are restricted to properties that explicitly allow them
#1037 closed
May 27, 2024 -
How to declare parameter values mixing possibilities
#1669 closed
May 27, 2024 -
Parameter style definitions inconsistent with the examples
#1945 closed
May 27, 2024 -
Proposal to improve wording of 'discriminator object' section
#2247 closed
May 25, 2024 -
[enhancement] reuse response description
#1741 closed
May 25, 2024 -
v3: How to require a multipart form data field?
#1954 closed
May 25, 2024 -
Support for ordered array query params
#883 closed
May 25, 2024 -
Use community repo for governance, info, & user/dev help questions
#3561 closed
May 24, 2024 -
Reusable components across repo's in a service oriented architecture
#3605 closed
May 24, 2024 -
Expand Style Examples
#3250 closed
May 24, 2024 -
Support UNIX domain sockets for testing APIs
#3011 closed
May 24, 2024 -
OpenAPI bundling proposal
#2685 closed
May 24, 2024 -
Support required in nested object
#2065 closed
May 24, 2024 -
XML Object - unfortunate default rule for name changes
#2096 closed
May 24, 2024 -
Ability to specify more complete examples in a specification
#2197 closed
May 24, 2024 -
Draft Features - accessibility
#1862 closed
May 24, 2024 -
Clarify [non-]validation of openIdConnect scopes
#1889 closed
May 24, 2024 -
Use designated labels in proposals to link to related issues & pull requests
#1905 closed
May 24, 2024 -
Flexible Path/URI Structure Using Linking
#783 closed
May 24, 2024 -
Relationship properties
#601 closed
May 24, 2024 -
Proposal for incorporating state transition into Open API
#1329 closed
May 24, 2024 -
openapi link vs hypermedia link to represent relationships in APIs
#2122 closed
May 24, 2024 -
Supporting typed links
#2069 closed
May 24, 2024 -
Link to operation mapping
#1315 closed
May 24, 2024 -
Variables/Parameters in Links
#1327 closed
May 24, 2024 -
Using Links to set a field in the target operation's request body
#1594 closed
May 24, 2024 -
Allow Links to Schema objects (Primitives/Objects/...)
#3228 closed
May 24, 2024 -
Feature suggestion: "Backlinks" - Links defined the inverse of the way they are currently
#2196 closed
May 24, 2024 -
link object scope
#1593 closed
May 24, 2024 -
Add ReadMe to Examples folder
#1245 closed
May 24, 2024 -
OAuth Flow required fields + validation
#2666 closed
May 24, 2024 -
Better handling of HTTP redirects
#2512 closed
May 24, 2024 -
Beyond 3.1: The New Big List of Possibilities
#2572 closed
May 24, 2024 -
Example of Parameters object reuse
#1029 closed
May 24, 2024 -
Support for object types in discriminator
#2731 closed
May 24, 2024 -
link object language
#1011 closed
May 24, 2024 -
Craft the OAS Guiding Principles
#676 closed
May 24, 2024 -
Structural improvements: move root externalDocs to info
#685 closed
May 24, 2024 -
Links issues
#1039 closed
May 24, 2024 -
Visibility and display attributes
#569 closed
May 24, 2024 -
[feature] support of $ref in licence fields
#3569 closed
May 24, 2024 -
[feature] support of $ref in contact fields
#3552 closed
May 24, 2024 -
Feature Request: $ref for Operation Object
#2922 closed
May 24, 2024 -
Allow the use of $ref and json pointer in tags
#2905 closed
May 24, 2024 -
change specification to permit $ref of server objects
#2338 closed
May 24, 2024 -
How do I refer to external `securitySchema` object ?
#1972 closed
May 24, 2024 -
Add security to the components object
#1850 closed
May 24, 2024 -
Allow Reference Object for 'tags' property of Swagger Object
#677 closed
May 24, 2024 -
Allow $ref in request body and response content objects
#3056 closed
May 24, 2024 -
Possible to use $ref in security and securityDefinitions?
#846 closed
May 24, 2024 -
Support for $ref in securityDefinitions
#680 closed
May 24, 2024 -
support references for examples
#625 closed
May 24, 2024 -
Definitions for error responses
#398 closed
May 24, 2024 -
Allow references between operations inside descriptions.
#239 closed
May 24, 2024 -
Define formal media type (MIME type) for Swagger Object
#110 closed
May 24, 2024 -
operationId - should exclude reserved characters
#2844 closed
May 24, 2024 -
How to generate OpenAPI specification models from XML examples?
#1451 closed
May 24, 2024 -
Support for SEARCH http method
#1306 closed
May 24, 2024 -
Where to put ancillary content
#1246 closed
May 24, 2024 -
Discuss JSONP support
#444 closed
May 24, 2024 -
Discriminator field (unnecessarily) required
#708 closed
May 24, 2024 -
[Meta issue] Improve error handling/documentation
#566 closed
May 24, 2024 -
Headers properties should be case insensitive.
#457 closed
May 24, 2024 -
Security Schema definition in the spec is not clear.
#461 closed
May 24, 2024 -
Interest in a JSON API-conformant example specification?
#476 closed
May 24, 2024 -
Proposal: Support for LINK and UNLINK HTTP methods
#480 closed
May 24, 2024 -
Allow multiple examples with optional label
#488 closed
May 24, 2024 -
allOf in paths to split paths into multiple files
#769 closed
May 24, 2024 -
support odata?
#230 closed
May 24, 2024 -
Need a way to mark response as error
#236 closed
May 24, 2024 -
Extracting common properties
#756 closed
May 24, 2024 -
Is this supposed to be a string or a JSON value?
#3289 closed
May 23, 2024 -
Add OAuth2 metadata url
#3595 closed
May 23, 2024 -
Audit, reorganize, and document labels (and probably also milestones)
#3509 closed
May 23, 2024
11 Issues opened by 5 people
-
Open Community (TDC) Meeting, Thursday 27 June 2024
#3925 opened
Jun 20, 2024 -
Open Community (TDC) Meeting, Thursday 20 June 2024
#3903 opened
Jun 13, 2024 -
Expert review criteria for registries (How exactly does x-twitter work?)
#3899 opened
Jun 11, 2024 -
Open Community (TDC) Meeting, Thursday 13 June 2024
#3888 opened
Jun 6, 2024 -
Add dark mode support to the HTML versions of the OpenAPI specs
#3866 opened
May 30, 2024 -
Preserve section links in ReSpec output
#3863 opened
May 28, 2024 -
Move examples to learn.openapis.org or spec.openapis.org
#3854 opened
May 24, 2024 -
Consolidated $ref-to-Some Object feature request
#3853 opened
May 24, 2024 -
Simplify HTML rendering build process
#3852 opened
May 24, 2024 -
Define and add new process labels and document general label usage in DEVELOPMENT.md
#3848 opened
May 23, 2024 -
Document milestone usage in DEVELOPMENT.md
#3847 opened
May 23, 2024
44 Unresolved conversations
Sometimes conversations happen on old items that aren’t yet closed. Here is a list of all the Issues and Pull Requests with unresolved conversations.
-
Formally define 3.x URL templating behavior
#3256 commented on
Jun 21, 2024 • 11 new comments -
Should we-organize our GitHub pages to a directory on main?
#3717 commented on
Jun 14, 2024 • 10 new comments -
What is our authoritative spec URL and how do people find it?
#3576 commented on
Jun 23, 2024 • 10 new comments -
Clarification on the purpose of the API license?
#726 commented on
Jun 23, 2024 • 7 new comments -
Multiple specifications for the header with the same name in components
#1572 commented on
Jun 6, 2024 • 7 new comments -
YAML JSON Schema is not enough for roundtrip-safe
#2951 commented on
Jun 23, 2024 • 6 new comments -
[new] scripts/update-schema-id.sh
#3814 commented on
Jun 20, 2024 • 4 new comments -
feat(spec): codify Encoding in specific requestBody mediatypes
#3837 commented on
Jun 20, 2024 • 3 new comments -
Are indexes in the query parameter array representable?
#1501 commented on
Jun 20, 2024 • 3 new comments -
Style guide / release checklist for the specification
#3785 commented on
Jun 23, 2024 • 3 new comments -
Questions about schemas for multipart and application/x-www-form-urlencoded request bodies
#2282 commented on
Jun 21, 2024 • 3 new comments -
Usage of `field` vs `property`
#2660 commented on
Jun 4, 2024 • 3 new comments -
Support all HTTP Methods
#1747 commented on
Jun 13, 2024 • 2 new comments -
Feature: sub-tags grouping
#1367 commented on
Jun 7, 2024 • 2 new comments -
Add support for importing non yaml files as block's
#1262 commented on
May 31, 2024 • 2 new comments -
Encrypted Payload Envelope
#550 commented on
May 31, 2024 • 2 new comments -
OIDC auth and token enpoints to support enironments like servers section does
#3101 commented on
May 25, 2024 • 2 new comments -
[new] scripts/update-schema-latest.sh
#3815 commented on
Jun 11, 2024 • 2 new comments -
We should not keep a minified version of respec.js
#3845 commented on
Jun 3, 2024 • 1 new comment -
Questions about Server Variable binding and defaults
#1675 commented on
Jun 21, 2024 • 1 new comment -
Add example/s as "Operation Request" child
#1673 commented on
May 30, 2024 • 1 new comment -
`primaryData` attribute in Media Type Object
#2454 commented on
May 28, 2024 • 1 new comment -
Establish governance docs for working groups
#3774 commented on
Jun 7, 2024 • 1 new comment -
Allow required as sibling of $ref (like summary/description)
#2498 commented on
May 24, 2024 • 1 new comment -
Proposal: Having an example for an entire operation in one place (request + response)
#859 commented on
Jun 14, 2024 • 1 new comment -
How to represent XML elements with attributes
#630 commented on
Jun 13, 2024 • 1 new comment -
RFC 7231 has been obsoleted by RFC 9110
#3800 commented on
Jun 13, 2024 • 1 new comment -
Add appendix "Informative references" to published spec documents
#3740 commented on
Jun 23, 2024 • 0 new comments -
Allow URI-references for Security Requirements (3.2.0)
#3821 commented on
May 24, 2024 • 0 new comments -
Extensible Security Scheme Object
#1515 commented on
Jun 12, 2024 • 0 new comments -
Minimum criteria for Namespace Registry
#3598 commented on
Jun 12, 2024 • 0 new comments -
Define and document branch strategy for the spec, both development and publishing
#3677 commented on
Jun 12, 2024 • 0 new comments -
Add top level XML code generation hints
#1652 commented on
Jun 9, 2024 • 0 new comments -
Synchronize 3.0.4, 3.1.1, and 3.2.0
#3626 commented on
Jun 3, 2024 • 0 new comments -
npm package not published?
#2400 commented on
May 31, 2024 • 0 new comments -
Did we break 3.2 compatibility by removing the Path Item $ref special case?
#3734 commented on
May 27, 2024 • 0 new comments -
Inconsistent usage of quotes in yaml examples
#1720 commented on
May 24, 2024 • 0 new comments -
Add 'name' field to servers
#1821 commented on
May 24, 2024 • 0 new comments -
Explain the term "schema" in definition section
#1423 commented on
May 24, 2024 • 0 new comments -
Permit multiple externalDocs
#1034 commented on
May 24, 2024 • 0 new comments -
JSON-LD
#1100 commented on
May 24, 2024 • 0 new comments -
Parameters for Media Types
#2342 commented on
May 23, 2024 • 0 new comments -
Request Content-Type matching underspecified?
#3162 commented on
May 23, 2024 • 0 new comments -
OAS 3.0 and 3.1 schemas require the Response Object `description` property but allow it to be empty
#3538 commented on
May 23, 2024 • 0 new comments