API

Deine Tools, unsere Zertifizierungstests

Dein LMS, CRM oder deine Website spricht mit ExamBoot: Wähle eine Zertifizierung und ihre Domänen, versende den Test per E-Mail und erhalte die Ergebnisse Domäne für Domäne.

Kostenlosen Trainerbereich öffnen Meine API-Schlüssel

In sechs Schritten

Hol dir deinen Schlüssel

Öffne in deinem Trainerbereich API-Schlüssel und erstelle einen Schlüssel. Kopiere ihn sofort: Er wird nur einmal angezeigt. Sende ihn bei jedem Aufruf im Header X-API-KEY (Authorization: Bearer geht auch).

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

Wähle die Zertifizierung und ihre Domänen

Der Katalog listet die Zertifizierungen, für die du Tests erstellen kannst, deine eigenen eingeschlossen. Jede Domäne nennt ihre ID und die Zahl der verfügbaren Fragen.

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}
]}

Erstelle und versende einen Test

Gib die Domänen und die Zahl der Fragen an (gleichmäßig verteilt) oder eine Zahl pro Domäne. Jede Person erhält eine E-Mail mit einem persönlichen Link und startet sofort, ohne Konto. Mit "send_email": false versendest du die Links selbst.

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"}]
  }'

Verfolge die Ergebnisse

Jede Person geht von gesendet über begonnen zu abgeschlossen. Danach hast du ihr Ergebnis insgesamt und pro Domäne.

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}, ...]}
}]

Fülle eine Klasse und teste sie

Erstelle eine Klasse mit den E-Mails deiner Lernenden: Sie treten mit einem kostenlosen Konto bei. Sende dann einen Test an die ganze Klasse mit class_id und verfolge den Fortschritt jedes Einzelnen.

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".

Lass dich benachrichtigen

Öffne in deinem Trainerbereich Webhooks und füge deine Adresse hinzu: Wenn jemand einen Test beendet, sendet ExamBoot das Ergebnis dorthin, Domäne für Domäne. Prüfe die Signatur mit dem Secret, das beim Hinzufügen angezeigt wird, und ignoriere eine bereits verarbeitete event_id.

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);

Alle Endpunkte

Jeder Pfad beginnt mit https://examboot.net/api/v1 und antwortet in JSON.

GET	/certifications	Die Zertifizierungen, für die du Tests erstellen kannst (Filter: vendor, search).
GET	/certifications/{id}	Eine Zertifizierung und ihre Domänen.
GET	/certifications/{id}/domains	Ihre Domänen mit den jeweils verfügbaren Fragen.
GET	/tests	Deine Tests, die neuesten zuerst, mit der Zahl der Abschlüsse.
POST	/tests	Einen Test erstellen und versenden.
GET	/tests/{code}	Ein Test, die Empfänger und ihre Ergebnisse.
POST	/tests/{code}/recipients	Den Test an weitere Personen senden.
POST	/tests/{code}/recipients/{id}/resend	Die E-Mail einer Person erneut senden.
GET	/classes	Deine Klassen.
POST	/classes	Eine Klasse erstellen und Lernende per E-Mail einladen.
GET	/classes/{id}	Eine Klasse, ihre Lernenden und offene Einladungen.
POST	/classes/{id}/invitations	Weitere Lernende einladen.
GET	/classes/{id}/progress	Der Fortschritt jedes Lernenden.

Gut zu wissen

Ein Schlüssel handelt in deinem Namen: Er sieht den Katalog und deine eigenen Zertifizierungen und nur deine Klassen und Tests.
Ein Test erreicht so viele Personen, wie du Plätze hast. Der kostenlose Trainerbereich umfasst 1 Klasse(n) und 2 Lernende.
Bis zu 120 Aufrufe pro Minute und 30 erstellte Tests oder Klassen pro Minute.
Ein abgelehnter Aufruf sagt, warum: 401 (Schlüssel fehlt oder widerrufen), 404 (nicht deins), 409 (über deinen Plan hinaus), 422 (ein Feld zu korrigieren, mit seinen Fehlern).
Bis zu 5 aktive Schlüssel. Widerrufe einen geleakten Schlüssel unter API-Schlüssel: Er funktioniert sofort nicht mehr.