Анонсирован OpenAPI v3.2: что нового в спецификации API
habr.comПроект 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, где можно получить
