The latest OpenAPI Initiative 3.2 spec is finally out! 🍾
Here’s why it matters:
- Use a base URL with $self. Big news if you have multiple environments
- Supports the QUERY method, a more concise way to retrieve data
- More detailed examples allowed by specifying both the structure and the serialized format
- New “Sequential” media types for streaming data
- An intuitive way to mark Security schemes as deprecated before sunsetting them
And many more improvements in this version that was announced today, so go check out the official spec and release notes!
OpenAPI 3.2 will help developers and PMs describe complex APIs with more accuracy.
Are you planning to adopt it soon in your API lifecycle and tooling? Let me know in the comments on the original LinkedIn post.