Анонсирован OpenAPI v3.2: что нового в спецификации API

Проект OpenAPI Initiative представил новую минорную версию спецификации — OpenAPI Specification v3.2.0, которая приносит ряд важных улучшений, особенно для тех, кто строит сложные API, работает с потоками данных и уделяет внимание безопасности. (OpenAPI Initiative)

Появилась новая структура Tag Object, включающая поля summary, parent (для вложенности) и kind (для классификации).

Теперь теги можно организовать в иерархии (например, "Products → Books") и задавать разные виды тегов, что упрощает визуализацию и группировку операций.

Введён реестр (registry) стандартных значений kind, чтобы сообщество могло делиться общепринятыми классификациями.

Спецификация теперь официально поддерживает HTTP-метод query — для безопасного запроса состояния ресурса с возможностью передавать сложные параметры (используя Schema Objects).

additionalOperations: возможность определять произвольные HTTP-методы, не только стандартные, с помощью Map, где каждый метод представлен стандартным Operation Object.

Введён новый компонент querystring, позволяющий задавать все параметры query как единый Schema Object — это упрощает валидацию и унификацию параметров запроса.

OpenAPI v3.2 добавляет официальную поддержку таких форматов:

Server-Sent Events (text/event-stream)

JSON Lines (application/jsonl)

JSON Sequences (application/json-seq)

Multipart Mixed (multipart/mixed)

Кроме того, введён ключ itemSchema, который позволяет описывать, как выглядят «события» в потоке — что важно при работе с реальной передачей данных на протяжении времени.

Добавлена поддержка OAuth 2.0 Device Authorization Flow — полезно для устройств с ограниченным вводом (телевизоры, киоски и др.).

Новое свойство oauth2MetadataUrl в объекте OAuth Flow, которое указывает на URL, где можно получить