Оказывается, релиз OpenAPI 3.1 был уже год назад.
Правда, с поддержкой новой версии пока все плохо. В основном есть у платных инструментов.
Что интересного:
• Теперь OpenAPI полностью поддерживает JSON-Schema. Счастье всем, кто ее активно использовал. • Описание методов стало опциональным. Теперь я могу в один док поместить только описания объектов и все. Очень удобно для документирования RPC API, очень не хватало этого раньше. • Появилось описание вебхуков. Не знаю, на сколько это полезно - коллбеки появились еще в 3.0, но так и не довелось встретиться с ними в реальности.Еще про изменения:
- Сравнение версий 2.0 и 3.0, 3.0 и 3.1
- Кратко про новинки 3.1