API Diff

API Diff — это простой и полезный веб-инструмент для тех, кому нужно сравнить две версии спецификации API. Всё работает максимально прозрачно: загружаете файлы или просто вставляете ссылки, и сервис наглядно показывает, что именно изменилось. Инструмент поддерживает стандарты OpenAPI и AsyncAPI, так что он идеально подходит и для RESTful, и для event-driven API.

Что особенно ценно: API Diff не просто подсвечивает правки в эндпоинтах, параметрах или схемах, но и четко маркирует «breaking changes». Это те самые критические изменения, которые могут «сломать» интеграции у ваших клиентов. Для тех, кто управляет развитием API, это незаменимая вещь.

Технически всё устроено удобно. Можно перетащить файлы мышкой, указать URL или использовать CLI-инструмент для локальной разработки. А для команд предусмотрен GitHub Action: он автоматически запускает diff при открытии pull request и пишет результат прямо в комментариях. Такая автоматизация позволяет отловить проблемные правки еще до того, как они попадут в продакшн. Интерфейс при этом остается минималистичным — всё внимание сосредоточено на сравнении версий в режиме side-by-side.

Кому это будет полезно? В первую очередь разработчикам и техписателям. Например, когда нужно быстро проверить pull request с обновленным OpenAPI файлом и понять, как изменения повлияют на систему. Продакт-менеджеры, в свою очередь, могут использовать отчеты, чтобы оценить масштаб новой версии API. А если встроить проверку в CI/CD пайплайны, можно вообще запретить внедрение критических изменений без предварительного ревью, что сделает ваш API гораздо стабильнее.