Сравнение OpenAPI-контрактов
Выделить изменения методов, обязательных полей и типов; классифицировать потенциально несовместимые изменения.
Методика и примеры
Сравнение OpenAPI-контрактов
Сравнивает локальные JSON-контракты OpenAPI3.0/3.1 по путям и методам, отмечает удаления и изменения required/type/enum как потенциальные риски. Полную совместимость не доказывает.
Входные данные примера
Основной источник
{
"openapi": "3.1.0",
"info": {
"title": "Локальный API",
"version": "1.0"
},
"paths": {
"/items": {
"get": {
"summary": "Список элементов",
"responses": {
"200": {
"description": "Успех"
}
}
}
}
}
}Второй источник
{
"openapi": "3.1.0",
"info": {
"title": "Локальный API",
"version": "2.0"
},
"paths": {
"/items": {
"post": {
"summary": "Создание",
"responses": {
"201": {
"description": "Создано"
}
}
}
}
}
}Результат примера
| operation | change | risk |
|---|---|---|
| /items|get | удалён метод | потенциально несовместимо |
| /items|post | добавлен метод | добавление |
Показано строк: 2 из 2.
Локальная обработка: до2 млн символов или20 000 записей на источник; до50 000 строк результата. Тяжёлые операции имеют отдельные ограничения и отмену. Измеренный спрос и внешние данные не подставляются.