Как определить в API, с какой версии поддерживается путь / параметр
У нас есть растущий swagger API/openAPI и для документирования изменений, которые мы хотели бы документировать по пути или параметру (и, возможно, определению), начиная с какой версии API он доступен.
Спецификация чванства знает info.version поле, но на paths или же parameters Я не мог найти что-то ссылающееся на эту версию.
Возможно , расширения вендора начинаются с x-... лайк x-since может быть полезным По крайней мере, проверка не перестает их использовать.
Но есть ли какая-либо существующая реализация для этого варианта использования?
1 ответ
Решение
Я не знаю ни одного существующего атрибута в спецификации OpenAPI/Swagger 2.0, чтобы удовлетворить ваши потребности, поэтому вы должны пойти с расширениями вендора (х-с, х-создано-на, х-создано-и т. Д.)