Gözetimi kendi sisteminize birkaç çağrıyla bağlayın.
REST API ile adayı davet edin, oturumları ve olayları çekin, olaylara abone olun. LMS’ler için LTI 1.3, kendi sınav motorunuz için platform entegrasyonu, kod yazmadan Zapier, Make ve n8n.
Altı bağlantı yolu
Aday davet ve veri
Aday davet edin, sınavları, oturumları ve olayları çekin; olay aboneliklerini (REST Hooks) yönetin.
LMS
Moodle 4.1+, Sakai 23+, Canvas ve D2L ile Dynamic Registration: kayıt adresini yapıştırın, iki sistem birbirini tanır. Puan not defterine yazılır.
Kendi sınav motorunuz
Sınavı sizin platformunuz yürütür, QProctor yalnız gözetir; sonuç imzalı bildirimle size döner.
Sonuç bildirimi
Her oturum bitince aday kimliği ve risk özeti imzalı JSON olarak adresinize gönderilir.
Zapier, Make, n8n
Oturum başladı, bitti, yüksek risk, el kaldırma ve aktivasyon olaylarına kod yazmadan abone olun.
Öğrenme kayıt sistemi (LRS)
Olaylar xAPI statement olarak LRS’e gider: attempted, completed, flagged, asked, registered.
Bağlantıyı deneyin
Bearer anahtarla tek çağrı
Anahtarı panelde Ayarlar › API ekranında oluşturun; anahtar yalnız oluşturulurken bir kez gösterilir. Önce /ben ile bağlantıyı deneyin; aday davetinde (POST /adaylar) yanıt adayın davet linkini döndürür.
- Geçerlilik: 30, 90, 180, 365 gün ya da süresiz
- Yetkisiz çağrı 403, süresi dolmuş anahtar 401 döner
- Aday davet yetkisi verilen anahtarla davet edilen adaya e-posta gider
curl https://PANEL-ADRESINIZ/api/v1/ben \
-H "Authorization: Bearer qp_ANAHTARINIZ"Uçlar ve yetkiler
Her anahtarın yetkileri ayrı ayrı seçilir; yalnız gereken izni verin.
| Uç | Yetki | Ne yapar |
|---|---|---|
| GET /ben | — | Bağlantı testi |
| GET /sinavlar | oku | Sınav listesi |
| GET /oturumlar | oturum_oku | Oturumlar ve sonuçlar (kişisel veri) |
| GET /olaylar/{olay}/ornek | oku | Olay türünün örnek JSON’u |
| POST /kancalar | kanca | Olaya abone ol (REST Hooks) |
| DELETE /kancalar | kanca | Aboneliği kaldır |
| POST /adaylar | aday_davet | Aday davet et, davet linkini al |
İmzalı ve teslimi garantili
- Sonuç webhook’u
- X-Proctor-Signature başlığında HMAC-SHA256 imza; Python ve Node.js doğrulama örnekleri panelde
- Webhook tekrar
- 2xx dönmezse en fazla 3 kez; session_id ile tekilleştirme önerilir
- Platform bildirimi
- x-ai-zaman ve x-ai-imza (HMAC-SHA256) başlıkları
- Platform tekrar
- Ulaşamazsa 1 dk, 5 dk, 15 dk, 1 sa, 6 sa ve 24 sa sonra; ayrıca yedek yoklama ucu
- LTI parametreleri
- exam_url, proctoring (ai | canli | canli_ai | kayit), sure_dk, dis_kimlik ve etkinlik başına gözetim ayarları
- Olay kodları
- 62 olay türü; rapor, webhook ve API aynı kodları ve risk ağırlıklarını kullanır
Anahtarınızı oluşturun, ilk çağrıyı bugün yapın
Ücretsiz hesap açın; Ayarlar › API ekranında anahtar oluşturup bağlantıyı deneyin.
Ücretsiz başla