# Детектор ломающих изменений OpenAPI diff Сравнивает схемы OpenAPI или GraphQL, помечает ломающие изменения и формирует отчет о влиянии для API-команд > Каноническая страница: https://elysiatools.com/ru/tools/openapi-diff-breach-detector - **Категория:** Development - **Ключевые слова:** openapi, graphql, diff, breaking changes, schema, api ## Обзор Детектор ломающих изменений OpenAPI diff — это специализированный инструмент для автоматического сравнения схем OpenAPI и GraphQL. Он анализирует старую и новую версии API, выявляет несовместимые (breaking) изменения и формирует подробный JSON-отчет об их влиянии. Это помогает командам разработчиков и архитекторам предотвращать поломки на стороне клиентов, оценивать риски перед релизом и поддерживать строгую обратную совместимость контрактов. ## Входные данные - **Старая схема** (textarea): Paste the previous OpenAPI YAML/JSON or GraphQL SDL here... - **Новая схема** (textarea): Paste the updated OpenAPI YAML/JSON or GraphQL SDL here... - **Тип схемы** (select) - **Формат ввода** (text) - **Добавить анализ влияния** (checkbox) ## Когда использовать - Перед слиянием (merge) изменений в основную ветку для проверки обратной совместимости API. - При обновлении контрактов между микросервисами для предотвращения сбоев интеграции. - Во время ревью изменений GraphQL-схем, чтобы убедиться в отсутствии удаленных полей или новых обязательных параметров. ## Как это работает - Вставьте текущую (старую) версию схемы OpenAPI (YAML/JSON) или GraphQL SDL в первое текстовое поле. - Добавьте обновленную (новую) версию схемы во второе поле. - Выберите тип схемы (OpenAPI или GraphQL) или оставьте автоматическое определение, а также включите опцию анализа влияния. - Инструмент сравнит обе схемы и сгенерирует JSON-отчет с указанием уровня риска релиза и списком всех ломающих изменений. ## Сценарии использования - Проверка pull request'ов на наличие изменений, которые могут сломать мобильные или веб-клиенты. - Генерация отчетов о рисках релиза для QA-инженеров и менеджеров продукта. - Аудит эволюции публичного API для составления корректного changelog'а для внешних разработчиков. ## Частые вопросы ### Какие форматы схем поддерживаются? Инструмент поддерживает схемы OpenAPI (Swagger) в форматах YAML и JSON, а также схемы GraphQL SDL. ### Что считается ломающим изменением (breaking change)? К ломающим изменениям относятся: удаление существующих полей ответа, добавление новых обязательных параметров запроса, изменение типов данных или удаление эндпоинтов. ### Можно ли отключить анализ влияния? Да, вы можете снять галочку «Добавить анализ влияния», если вам нужен только базовый список отличий без оценки рисков для клиентов. ### Как инструмент определяет тип схемы? По умолчанию используется автоопределение на основе синтаксиса (auto detect), но вы можете вручную выбрать OpenAPI или GraphQL в настройках. ### В каком формате выдается результат? Результат предоставляется в структурированном формате JSON, который содержит сводку изменений, пути к измененным элементам и уровень риска. ## Связанные инструменты - [Стресс-тестер API-контрактов](https://elysiatools.com/ru/tools/api-contract-stress-tester): Создает граничные тесты по OpenAPI 3.x и при необходимости отправляет их в реальный backend для поиска расхождений с контрактом. - [Синхронизатор палитры Tailwind](https://elysiatools.com/ru/tools/tailwind-color-palette-sync): Введите HEX, выберите схему именования (шкала 50–950 / одно имя / вложенность) — генерирует фрагмент theme.extend.colors для tailwind.config.ts с уровнями WCAG AA/AAA. Тёмная тема опциональна. - [Объяснитель выражений Cron](https://elysiatools.com/ru/tools/cron-expression-explainer): Разбирает cron-выражение (5/6 полей или Quartz) в описание на естественном языке, разбивает по полям и выводит следующие N запусков в любой зоне IANA, с ИИ-объяснением - [Генератор CSS masonry layout](https://elysiatools.com/ru/tools/css-masonry-layout-generator): Генерирует чистый CSS masonry layout с брейкпоинтами, отступами и исключаемыми элементами - [Конвертер cURL в Go (net/http)](https://elysiatools.com/ru/tools/curl-to-go): Преобразует команду cURL в фрагмент кода Go net/http с http.NewRequest, заголовками и телом - [Конвертер cURL в JavaScript (axios)](https://elysiatools.com/ru/tools/curl-to-js-axios): Преобразует команду cURL в фрагмент кода JavaScript axios с объектом конфигурации, заголовками и данными - [Конвертер cURL в JavaScript (fetch)](https://elysiatools.com/ru/tools/curl-to-js-fetch): Преобразует команду cURL в фрагмент кода JavaScript fetch() с заголовками, телом и методом - [Конвертер cURL в PHP (cURL)](https://elysiatools.com/ru/tools/curl-to-php): Преобразует команду cURL в фрагмент кода PHP cURL с curl_setopt, заголовками и POST-полями ## Примеры - [Примеры OpenAPI/Swagger](https://elysiatools.com/ru/samples/openapi): Примеры спецификации OpenAPI/Swagger для документации REST API и определения контрактов - [Примеры OpenAPI/Swagger](https://elysiatools.com/ru/samples/openapi-swagger): Комплексные примеры документации API с использованием OpenAPI 3.0 и спецификаций Swagger для RESTful сервисов - [Примеры Обработки Изображений Android Java](https://elysiatools.com/ru/samples/android-image-processing-java): Примеры обработки изображений Android Java включая чтение/сохранение, масштабирование и преобразование формата - [Примеры Обработки Изображений Android Kotlin](https://elysiatools.com/ru/samples/android-image-processing-kotlin): Примеры обработки изображений Android Kotlin включая чтение/сохранение, масштабирование и преобразование формата ## Связанные материалы - [Инструменты OpenAPI для документации, кодогенерации и ревью контрактов](https://elysiatools.com/ru/hubs/openapi-utility): Сравните в одном хабе генерацию кода OpenAPI, документацию API, diff схем, проверку ответов и контрактное тестирование для проектирования и сопровождения API. - [Инструменты для тестирования API-контрактов, моков и проверки схем](https://elysiatools.com/ru/hubs/api-contract-testing): Преобразуйте OpenAPI в типы и документацию, поднимайте моки, проверяйте реальные ответы и отслеживайте опасные изменения схем в одном hub. - [Инструменты для версионирования API, проверки breaking changes и готовности к релизу](https://elysiatools.com/ru/hubs/api-versioning-breaking-change-review): Сравнивайте версии API, находите ломающие изменения схемы, проверяйте совместимость реальных ответов и ревьюйте semver и changelog в одном релизном hub. - [Инструменты сравнения и diff файлов и данных](https://elysiatools.com/ru/hubs/file-data-diff-comparison-tools): Сравните два файла, полезных нагрузки, схемы или набора данных рядом и подсветите, что изменилось — в тексте, JSON, CSV/Excel, PDF, изображениях, аудио, базах данных, API и конфигах.