Development
Сравнивает схемы OpenAPI или GraphQL, помечает ломающие изменения и формирует отчет о влиянии для API-команд
Вызовите этот инструмент из своего кода на трёх языках.
curl -X POST 'https://api.elysiatools.com/ru/api/tools/openapi-diff-breach-detector' \
-H 'Content-Type: application/json' \
-d '{"oldSchema":"openapi: 3.0.0\npaths:\n /users/{id}:\n get:\n responses:\n \"200\":\n description: ok\n content:\n application/json:\n schema:\n type: object\n properties:\n id: { type: string }\n email: { type: string }\n","newSchema":"openapi: 3.0.0\npaths:\n /users/{id}:\n get:\n responses:\n \"200\":\n description: ok\n content:\n application/json:\n schema:\n type: object\n properties:\n id: { type: string }\n","schemaType":"openapi","inputFormat":"auto","includeImpactAnalysis":true}'Отправьте POST-запрос с входными данными в JSON. Параметры типа «файл» требуют предварительной загрузки.
POST https://api.elysiatools.com/ru/api/tools/openapi-diff-breach-detector| Имя | Тип | Обязательный | Описание |
|---|---|---|---|
| oldSchema | textarea | Да | — |
| newSchema | textarea | Да | — |
| schemaType | select | Нет | — |
| inputFormat | text | Нет | — |
| includeImpactAnalysis | checkbox | Нет | — |
JSON-результат
{
"key": {...},
"metadata": {
"key": "value"
},
"error": "Error message (optional)",
"message": "Notification message (optional)"
}Добавьте этот инструмент на свой сервер Model Context Protocol, чтобы ИИ-агенты могли перечислять и вызывать его.
Добавьте этот блок в конфигурацию вашего MCP-клиента:
{
"mcpServers": {
"elysiatools-openapi-diff-breach-detector": {
"name": "openapi-diff-breach-detector",
"description": "Сравнивает схемы OpenAPI или GraphQL, помечает ломающие изменения и формирует отчет о влиянии для API-команд",
"baseUrl": "https://api.elysiatools.com/mcp/sse?toolId=openapi-diff-breach-detector",
"command": "",
"args": [],
"env": {},
"isActive": true,
"type": "sse"
}
}
}После подключения к SSE-endpoint выведите список доступных инструментов:
{
"jsonrpc": "2.0",
"id": 1,
"method": "tools/list"
}Вызовите инструмент по его id; аргументы формируются из его параметров:
{
"jsonrpc": "2.0",
"id": 2,
"method": "tools/call",
"params": {
"name": "openapi-diff-breach-detector",
"arguments": {
"oldSchema": "openapi: 3.0.0\npaths:\n /users/{id}:\n get:\n responses:\n \"200\":\n description: ok\n content:\n application/json:\n schema:\n type: object\n properties:\n id: { type: string }\n email: { type: string }\n",
"newSchema": "openapi: 3.0.0\npaths:\n /users/{id}:\n get:\n responses:\n \"200\":\n description: ok\n content:\n application/json:\n schema:\n type: object\n properties:\n id: { type: string }\n",
"schemaType": "openapi",
"inputFormat": "auto",
"includeImpactAnalysis": true
}
}
}Вопросы или проблемы? Свяжитесь с [email protected]