OpenAPI 3.2.0 introduces incremental but significant improvements to the API specification standard. Key updates include first-class support for streaming media types (text/event-stream, application/jsonl) with schema definitions for individual stream items, hierarchical tag organization for better API navigation, support for extended HTTP methods including the QUERY method through additionalOperations, clarified path templating semantics for consistent routing across tools, clearer example semantics distinguishing data-level from serialized representations, and explicit OAuth 2.0 Device Authorization Flow support. These changes standardize patterns that previously required vendor extensions, making the specification more expressive for modern API designs while maintaining backward compatibility.

7m read timeFrom nordicapis.com
Post cover image
Table of contents
Structured Tags and Hierarchical OrganizationFirst-Class Support for Streaming Media TypesOpenAPI 3.2.0 Extends HTTP Methods and additionalOperationsClarified Path Templating and Routing SemanticsClearer Example Semantics for Data and SerializationOAuth 2.0 Device Flow and Security Metadata UpdatesThe Implications of OpenAPI 3.2.0AI Summary

Sort: