Validation
Valide structurellement les documents OpenAPI 3.0/3.1 et Swagger 2.0 : champs requis, complétude des chemins/opérations, codes de réponse, résolution des $ref, unicité des operationId et intégrité des composants
Appelez cet outil depuis votre code en trois langages.
curl -X POST 'https://api.elysiatools.com/fr/api/tools/openapi-validator' \
-H 'Content-Type: application/json' \
-d '{"specInput":"openapi: 3.0.3\ninfo:\n title: Example API\n version: 1.0.0\npaths:\n /users:\n get:\n summary: List users\n responses:\n '\''200'\'':\n description: OK"}'Envoyez une requête POST avec vos entrées en JSON. Les paramètres de type fichier nécessitent un upload préalable.
POST https://api.elysiatools.com/fr/api/tools/openapi-validator| Nom | Type | Requis | Description |
|---|---|---|---|
| specInput | textarea | Oui | — |
Résultat HTML
{
"result": "<div>Processed HTML content</div>",
"error": "Error message (optional)",
"message": "Notification message (optional)",
"metadata": {
"key": "value"
}
}Ajoutez cet outil à votre serveur Model Context Protocol pour que les agents IA puissent le lister et l'appeler.
Ajoutez ce bloc à la configuration de votre client MCP :
{
"mcpServers": {
"elysiatools-openapi-validator": {
"name": "openapi-validator",
"description": "Valide structurellement les documents OpenAPI 3.0/3.1 et Swagger 2.0 : champs requis, complétude des chemins/opérations, codes de réponse, résolution des $ref, unicité des operationId et intégrité des composants",
"baseUrl": "https://api.elysiatools.com/mcp/sse?toolId=openapi-validator",
"command": "",
"args": [],
"env": {},
"isActive": true,
"type": "sse"
}
}
}Après connexion au point d'accès SSE, listez les outils exposés :
{
"jsonrpc": "2.0",
"id": 1,
"method": "tools/list"
}Appelez l'outil par son id ; les arguments sont construits à partir de ses paramètres :
{
"jsonrpc": "2.0",
"id": 2,
"method": "tools/call",
"params": {
"name": "openapi-validator",
"arguments": {
"specInput": "openapi: 3.0.3\ninfo:\n title: Example API\n version: 1.0.0\npaths:\n /users:\n get:\n summary: List users\n responses:\n '200':\n description: OK"
}
}
}Des questions ou un problème ? Contactez [email protected]