API

आपके टूल, हमारे प्रमाणन टेस्ट

आपका LMS, CRM या वेबसाइट ExamBoot से बात करता है: एक प्रमाणन और उसके डोमेन चुनें, टेस्ट ईमेल से भेजें, परिणाम डोमेन-दर-डोमेन पाएँ।

छह चरणों में

1

अपनी कुंजी पाएँ

अपने प्रशिक्षक स्थान में API कुंजियाँ खोलें और एक कुंजी बनाएँ। उसे तुरंत कॉपी करें: वह केवल एक बार दिखाई जाती है। हर कॉल के X-API-KEY हेडर में भेजें (Authorization: Bearer भी चलता है)।

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

प्रमाणन और उसके डोमेन चुनें

कैटलॉग उन प्रमाणनों की सूची देता है जिन पर आप टेस्ट बना सकते हैं, आपके अपने भी। हर डोमेन अपना 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}
]}
3

टेस्ट बनाएँ और भेजें

डोमेन और प्रश्नों की संख्या दें (बराबर बाँटी जाती है), या हर डोमेन के लिए एक संख्या। हर व्यक्ति को निजी लिंक वाला ईमेल मिलता है और वह बिना खाते के तुरंत शुरू करता है। लिंक खुद भेजने के लिए "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"}]
  }'
4

परिणाम देखें

हर व्यक्ति भेजा गया से शुरू हुआ और फिर पूरा हुआ तक जाता है। पूरा होने पर आपको उसका कुल और डोमेन-वार स्कोर मिलता है।

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

कक्षा भरें और उसका टेस्ट लें

अपने छात्रों के ईमेल के साथ कक्षा बनाएँ: वे मुफ़्त खाते से जुड़ते हैं। फिर 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".
6

पूरा होने पर सूचना पाएँ

अपने प्रशिक्षक स्थान में वेबहुक खोलें और अपना पता जोड़ें: जब कोई टेस्ट पूरा करता है, 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 कुंजियाँ में रद्द करें: वह तुरंत काम करना बंद कर देती है।