Documentation Développeurs, REST API v1 & Serveur MCP — Super Code France
Super Code France (supercode.fr) expose une API REST publique versionnée (v1) sans authentification requise (sandbox / accès gratuit immédiat) ainsi qu'un serveur Model Context Protocol (MCP) en Streamable HTTP pour les agents IA.
1. Spécification OpenAPI 3.1 & Découverte
- Spécification OpenAPI 3.1 (
/openapi.json) - Catalogue API RFC 9727 (
/.well-known/api-catalog) - MCP Server Card (
/.well-known/mcp/server-card.json) - Manifeste ARD (
/.well-known/ai-catalog.json) - Authentification & Inscription Agents (
/auth.md) - Résumé LLM (
/llms.txt) & Référentiel Complet ETG 2026 (/llms-full.txt)
2. Endpoints REST API v1 (Accès Public Sans Clé API)
curl -i https://supercode.fr/api/v1/cartes-memos?from=0&to=9
curl -i https://supercode.fr/api/v1/health3. Serveur MCP (Streamable HTTP JSON-RPC 2.0)
Endpoint : POST https://supercode.fr/api/mcp
curl -X POST https://supercode.fr/api/mcp \
-H "Content-Type: application/json" \
-d '{"jsonrpc":"2.0","id":1,"method":"tools/list","params":{}}'4. Politique de Versionnement, Rate Limiting & Erreurs Typées
Toutes les réponses incluent les en-têtes standards RateLimit-Limit, RateLimit-Remaining et RateLimit-Reset. Les erreurs (400, 404, 429, 500) retournent un objet JSON structuré avec error.code, error.message et error.hint. Toute dépréciation d'endpoint est annoncée au moins 90 jours à l'avance via les en-têtes HTTP Deprecation et Sunset.