API publique & agents IA
Centre Stage Permis expose une surface machine publique, sans authentification : disponibilités en temps réel des stages de récupération de points agréés préfecture, centres partenaires et base d'articles. Deux interfaces équivalentes : REST et MCP.
REST : GET /api/stages
Paramètres (tous optionnels) : city, dept, region, from/to (YYYY-MM-DD), maxPrice (euros), limit (max 100), includeUnavailable. Par défaut, seules les sessions réservables sont renvoyées.
curl "https://centrestagepermis.fr/api/stages?city=lyon&maxPrice=250&limit=5"
Spécification complète : /openapi.json · Santé : /api/health
MCP : POST /api/mcp
Serveur MCP (JSON-RPC) sans authentification. Outils : search_stages, check_availability, get_centre, list_articles, get_article.
curl -X POST https://centrestagepermis.fr/api/mcp \
-H "Content-Type: application/json" \
-d '{"jsonrpc":"2.0","method":"tools/list","id":1}'Server card : /.well-known/mcp/server-card.json
Découverte pour agents
- /.well-known/api-catalog : catalogue d'APIs (RFC 9727)
- /.well-known/agent-skills/index.json : index des skills agents
- /llms.txt : manifeste de contenu pour LLMs
- /auth.md : authentification (spoiler : aucune requise)
Règles d'usage
Rate limits par IP (généreux pour un usage poli, HTTP 429 = réessayer plus tard). La réservation et le paiement sont toujours finalisés par l'utilisateur humain sur le site : orientez l'utilisateur vers la page de session (bookingUrl dans chaque résultat). Une question ? Contact.