Product update: OpenAPI 3.2 partial support#425
Conversation
✅ Deploy Preview for bump-content-hub ready!
To edit notification comments on pull requests, go to your Netlify project configuration. |
| --- | ||
| title: "OpenAPI 3.2: partial support" | ||
| tags: [Improvement] | ||
| image: /images/changelog/ask-ai.png |
There was a problem hiding this comment.
Oops, I changed the image but not the "informational tag"
| If you didn't hear about this new version, feel free to read our [OpenAPI complete guide](/guides/openapi/specification/v3.2/introduction/what-is-openapi/), updated for OpenAPI 3.2. | ||
|
|
||
| We started supporting some of the features brought by this new version: | ||
| - The QUERY method is now supported in both the documentation and the API Explorer. |
There was a problem hiding this comment.
Is it intentional to not mention other operations described via additionalOperations ? (I know I need to test the last PR of the lib curl_generator to verify support on Explorer too)
There was a problem hiding this comment.
Are you talking about specific methods, or any verbs?
If it's about being able to add any verbs, I'll update only the help center page once it's fully verified 🙏
There was a problem hiding this comment.
that's indeed about specific methods or verbs, that we support, except on the explorer side (where I didn't time yet to verify the fix on curl-generator lib).
| - `summary` can be added to responses when the level of detail doesn't justify the use of the existing `description` field. | ||
| - Security schemes can now be `deprecated`. | ||
|
|
||
| OpenAPI 3.2 definition files can be deployed through your usual deployment process: using the Github Action, the CLI, the API, or directly in your Bump.sh dashboard. |
There was a problem hiding this comment.
While here, we could add a link to our own API documentation 🤩
There was a problem hiding this comment.
While here, we could add a link to our own API documentation 🤩
Added 💙
Here's a straight to the point product update to share some love for the partial support of OpenAPI 3.2 provided by Polo 💙