OpenAPI как источник правды об API: избавляемся от расхождений в документации
В большинстве команд API-документация живёт в трёх местах одновременно: Notion или Confluence с описаниями эндпоинтов, Postman-коллекция у разработчиков, и реальный код на сервере. Они расходятся незаметно — кто-то добавил поле в ответ и не обновил вики, кто-то переименовал параметр. Через полгода документация врёт, коллекция устарела, и единственный источник правды — это исходный код, который нужно…