L'API REST EduGame v1 expose plus de 64 endpoints organises en six domaines. Base URL : https://api.edugame.cc/v1. Specification OpenAPI 3.1 disponible a /v1/openapi.json.
Deux modes d'authentification sont supportes, tous deux utilisables via l'en-tete Authorization.
Usage serveur-a-serveur, scripts, integrations backend. Format eg_live_xxxxxxxxxxxx.
Authorization: Bearer eg_live_...Usage client-a-serveur ou applications tierces agissant au nom d'un utilisateur. Refresh tokens supportes.
Authorization: Bearer egat_...14 endpoints
Generation d'examens, lecture de l'arbre, edition par node, validation du blueprint, export PDF variabilise et rendu papier.
POST /v1/exams8 endpoints
Pipeline Double-Pass pour cours pedagogiques : architecture, redaction section par section, publication dans la bibliotheque enseignant.
POST /v1/courses6 endpoints
Generation de jeux educatifs Phaser 4 configures via modules composables (BattleQuiz, RelayRace, Simulation, Narrative, etc.).
POST /v1/games10 endpoints
Consultation et search du programme officiel : matieres, niveaux, sequences, chapitres, competences du socle commun, taxonomie Bloom.
GET /v1/curriculum/subjects8 endpoints
Abonnement, desabonnement, liste et test des webhooks. 60 types d'evenements disponibles avec signature HMAC-SHA256.
POST /v1/webhooks12 endpoints
Catalogue createur, achat de contenus, enrollment, payouts, white-label branding. Economie createur avec commissions configurables.
GET /v1/marketplace/productsLes listes utilisent une pagination par curseur via les params limit (max 100) et cursor. La reponse inclut next_cursor (null sur la derniere page).
Toutes les routes de mutation acceptent l'en-tete Idempotency-Key. La meme cle garantit un resultat identique pendant 24 heures. Un payload different avec la meme cle retourne 409.
Chaque reponse contient un en-tete X-Trace-Id. Transmettez-le au support pour accelerer le diagnostic : il correspond au log structure cote serveur.
Chaque tier dispose de son propre quota RPM (requetes par minute) et quotidien. Les en-tetes X-RateLimit-Limit, X-RateLimit-Remaining et X-RateLimit-Reset sont retournes sur chaque reponse.
| Tier | RPM | Quotidien |
|---|---|---|
| Decouverte | 60 | 1 000 |
| Essentiel | 600 | 25 000 |
| Integral | 1 800 | 100 000 |
| Enterprise | sur mesure | sur mesure |
Toutes les erreurs respectent le format RFC 7807 (Problem Details). Le champ code est stable et destine a etre consomme par votre code.
| HTTP | code | Description |
|---|---|---|
| 400 | validation_error | Payload JSON ou query invalide. Voir details. |
| 401 | unauthorized | Cle API absente, malformee ou revoquee. |
| 403 | forbidden_scope | Scope insuffisant pour cette route. |
| 404 | not_found | Ressource inexistante ou inaccessible avec ce scope. |
| 409 | conflict | Idempotency key deja utilisee avec un payload different. |
| 429 | rate_limited | Quota tier depasse. Voir Retry-After. |
| 500 | internal_error | Erreur interne. Tracee avec un traceId retourne. |