API

您的工具，我们的认证测试

您的 LMS、CRM 或网站与 ExamBoot 对接：选择认证及其领域，通过邮件发送测试，按领域获取结果。

六个步骤

获取密钥

在讲师空间中打开 API 密钥并创建一个密钥。请立即复制：它只显示一次。在每次调用的 X-API-KEY 请求头中发送（也支持 Authorization: Bearer）。

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

选择认证及其领域

目录列出您可以创建测试的认证，包括您自己的认证。每个领域都给出其 ID 和可用题目数量。

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

创建并发送测试

提供领域和题目数量（平均分配），或为每个领域指定数量。每个人都会收到带个人链接的邮件，无需账户即可立即开始。添加 "send_email": false 可自行发送链接。

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

跟踪结果

每个人的状态从已发送到已开始，再到已完成。完成后，您将获得其总分和各领域得分。

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

组建班级并进行测试

用学员的邮箱创建班级：他们用免费账户加入。然后用 class_id 向整个班级发送测试，并跟踪每位学员的进度。

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

完成时收到通知

在讲师空间中打开 Webhooks 并添加您的地址：有人完成测试时，ExamBoot 会按领域将结果发送到该地址。请用添加时显示的密钥校验签名，并忽略已处理过的 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);

全部接口

每个路径都以 https://examboot.net/api/v1 开头，并以 JSON 响应。

GET	/certifications	可创建测试的认证（筛选：vendor、search）。
GET	/certifications/{id}	一个认证及其领域。
GET	/certifications/{id}/domains	其领域，以及每个领域的可用题目。
GET	/tests	您的测试，最新的在前，附完成人数。
POST	/tests	创建并发送测试。
GET	/tests/{code}	一个测试、收到它的人及其结果。
POST	/tests/{code}/recipients	将测试发送给更多人。
POST	/tests/{code}/recipients/{id}/resend	重新发送某人的邮件。
GET	/classes	您的班级。
POST	/classes	创建班级并通过邮件邀请学员。
GET	/classes/{id}	一个班级、其学员和待处理的邀请。
POST	/classes/{id}/invitations	邀请更多学员。
GET	/classes/{id}/progress	每位学员的进度。

须知

密钥以您的名义操作：它能看到目录和您自己的认证，且只能看到您的班级和测试。
一个测试最多发送给与您席位数相同的人数。免费讲师空间包含 1 个班级和 2 名学员。
每分钟最多 120 次调用，每分钟最多创建 30 个测试或班级。
被拒绝的调用会说明原因：401（缺少密钥或已撤销）、404（不属于您）、409（超出您的方案）、422（需修正的字段及其错误）。
最多 5 个有效密钥。在 API 密钥中撤销泄露的密钥：它会立即失效。