API

Vos outils, nos tests de certification

Votre LMS, votre CRM ou votre site parle à ExamBoot : choisissez une certification et ses domaines, envoyez le test par email, recevez les résultats domaine par domaine.

Ouvrir un espace formateur gratuit Mes clés API

En six étapes

Obtenez votre clé

Dans votre espace formateur, ouvrez Clés API et créez une clé. Copiez-la aussitôt : elle n'est affichée qu'une fois. Envoyez-la dans l'en-tête X-API-KEY de chaque appel (Authorization: Bearer marche aussi).

curl https://examboot.net/api/v1/certifications \
  -H "X-API-KEY: ebk_your_key"

Choisissez la certification et ses domaines

Le catalogue liste les certifications sur lesquelles vous pouvez créer un test, les vôtres comprises. Chaque domaine donne son ID et le nombre de questions disponibles.

curl https://examboot.net/api/v1/certifications/12/domains \
  -H "X-API-KEY: ebk_your_key"

{"data": [
  {"id": 41, "name": "Security and Risk Management", "questions": 180},
  {"id": 42, "name": "Asset Security", "questions": 95}
]}

Créez et envoyez un test

Donnez les domaines et le nombre de questions (réparti à parts égales), ou un nombre par domaine. Chacun reçoit un email avec un lien personnel et commence aussitôt, sans compte. Ajoutez "send_email": false pour envoyer les liens vous-même.

curl -X POST https://examboot.net/api/v1/tests \
  -H "X-API-KEY: ebk_your_key" \
  -H "Content-Type: application/json" \
  -d '{
    "certification_id": 12,
    "domains": [41, 42],
    "questions": 20,
    "recipients": [{"email": "[email protected]", "name": "Ada"}]
  }'

Suivez les résultats

Chaque personne passe de envoyé à commencé puis terminé. Une fois terminé, vous avez son score global et par domaine.

curl https://examboot.net/api/v1/tests/TEST_CODE \
  -H "X-API-KEY: ebk_your_key"

"recipients": [{
  "email": "[email protected]",
  "status": "completed",
  "result": {"percent": 75, "correct": 15, "questions": 20,
    "domains": [{"id": 41, "name": "Security and Risk Management", "percent": 80}, ...]}
}]

Remplissez une classe et testez-la

Créez une classe avec les emails de vos élèves : ils la rejoignent avec un compte gratuit. Envoyez ensuite un test à toute la classe avec class_id et suivez la progression de chacun.

curl -X POST https://examboot.net/api/v1/classes \
  -H "X-API-KEY: ebk_your_key" \
  -H "Content-Type: application/json" \
  -d '{"name": "CISSP evening cohort", "certification_id": 12,
       "emails": ["[email protected]", "[email protected]"]}'

# Then: POST /tests with "class_id" instead of "recipients".

Soyez prévenu à la fin

Dans votre espace formateur, ouvrez Webhooks et ajoutez votre adresse : quand quelqu'un termine un test, ExamBoot y envoie le résultat, domaine par domaine. Vérifiez la signature avec le secret affiché à l'ajout, et ignorez un event_id déjà traité.

POST https://your-site.example/examboot-hook
X-Webhook-Event: test.completed
X-Webhook-Event-Id: 6f1c2e0a-…
X-Webhook-Signature: HMAC-SHA256 of the raw body, with your whsec_ secret

{"event": "test.completed",
 "payload": {"test": "TEST_CODE", "score": 75, "correct": 15, "questions": 20,
   "recipient": {"email": "[email protected]", "name": "Ada"},
   "domains": [...], "event_id": "6f1c2e0a-…"},
 "sent_at": "2026-10-15T09:30:00+00:00"}

// PHP
hash_equals(hash_hmac('sha256', $rawBody, $secret), $signature);

Tous les endpoints

Chaque chemin commence par https://examboot.net/api/v1 et répond en JSON.

GET	/certifications	Les certifications sur lesquelles créer un test (filtres : vendor, search).
GET	/certifications/{id}	Une certification et ses domaines.
GET	/certifications/{id}/domains	Ses domaines, avec les questions disponibles dans chacun.
GET	/tests	Vos tests, du plus récent au plus ancien, avec le nombre de personnes qui les ont terminés.
POST	/tests	Créer un test et l'envoyer.
GET	/tests/{code}	Un test, les personnes qui l'ont reçu et leurs résultats.
POST	/tests/{code}/recipients	Envoyer le test à d'autres personnes.
POST	/tests/{code}/recipients/{id}/resend	Renvoyer l'email d'une personne.
GET	/classes	Vos classes.
POST	/classes	Créer une classe et inviter des élèves par email.
GET	/classes/{id}	Une classe, ses élèves et ses invitations en attente.
POST	/classes/{id}/invitations	Inviter d'autres élèves.
GET	/classes/{id}/progress	La progression de chaque élève.

Bon à savoir

Une clé agit en votre nom : elle voit le catalogue et vos propres certifications, et seulement vos classes et vos tests.
Un test atteint autant de personnes que vous avez de places. L'espace formateur gratuit comprend 1 classe(s) et 2 élèves.
Jusqu'à 120 appels par minute, et 30 tests ou classes créés par minute.
Un appel refusé dit pourquoi : 401 (clé absente ou révoquée), 404 (pas à vous), 409 (au-delà de votre offre), 422 (un champ à corriger, avec ses erreurs).
Jusqu'à 5 clés actives. Révoquez une clé divulguée dans Clés API : elle cesse aussitôt de fonctionner.