Development

Detecteur de rupture OpenAPI diff

Compare des schemas OpenAPI ou GraphQL, signale les breaking changes et genere un rapport dimpact pour les equipes API

json· Résultat JSONOuvrir l'outil

Démarrage rapide

Appelez cet outil depuis votre code en trois langages.

cURL

curl -X POST 'https://api.elysiatools.com/fr/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}'

Référence de l'API

Envoyez une requête POST avec vos entrées en JSON. Les paramètres de type fichier nécessitent un upload préalable.

Point d'accès

HTTP

POST https://api.elysiatools.com/fr/api/tools/openapi-diff-breach-detector

Paramètres

Nom	Type	Requis	Description
oldSchema	textarea	Oui	—
newSchema	textarea	Oui	—
schemaType	select	Non	—
inputFormat	text	Non	—
includeImpactAnalysis	checkbox	Non	—

Format de réponse

Résultat JSON

JSON

{
  "key": {...},
  "metadata": {
    "key": "value"
  },
  "error": "Error message (optional)",
  "message": "Notification message (optional)"
}

Intégration MCP

Ajoutez cet outil à votre serveur Model Context Protocol pour que les agents IA puissent le lister et l'appeler.

Configuration du serveur

Ajoutez ce bloc à la configuration de votre client MCP :

mcp.json

{
  "mcpServers": {
    "elysiatools-openapi-diff-breach-detector": {
      "name": "openapi-diff-breach-detector",
      "description": "Compare des schemas OpenAPI ou GraphQL, signale les breaking changes et genere un rapport dimpact pour les equipes API",
      "baseUrl": "https://api.elysiatools.com/mcp/sse?toolId=openapi-diff-breach-detector",
      "command": "",
      "args": [],
      "env": {},
      "isActive": true,
      "type": "sse"
    }
  }
}

Lister les outils disponibles

Après connexion au point d'accès SSE, listez les outils exposés :

tools/list

{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/list"
}

Appeler cet outil

Appelez l'outil par son id ; les arguments sont construits à partir de ses paramètres :

tools/call

{
  "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
}
  }
}

Chaînez plusieurs outils dans une session avec une liste toolId séparée par des virgules, ex. /mcp/sse?toolId=png-to-webp,jpg-to-webp,gif-to-webp (20 max).

Des questions ou un problème ? Contactez [email protected]