Gerçek Allstar entegrasyonu gelene kadar Kütüphanem geliştirmesi için. Veriler uydurmadır ve sabittir: aynı istek hep aynı yanıtı verir.
Taban adres: https://api.ucdortbesallstarbi.com. Her /v1 isteğinde Authorization: Bearer <anahtar> gerekir. Yanıt: { data, meta? }, hata: { error: { code, message } }.
Hata denemek için: X-Fake-Fail: 401|429|500|503, gecikme için X-Fake-Delay: 1500 (ms, en çok 10000).
Örnek kimlikler: okul sch_1001, sınıf cls_8c, öğrenci stu_8c_01, öğretmen tch_001, kitap bk_mat8_dk, soru Q-MAT8-DK-00001. Makine okur liste: /v1.
| İstek | Ne yapar | Görev |
|---|---|---|
POST /v1/auth/qr/sessions | Test için bir QR yükü üretir (Allstar uygulamasının ekranda göstereceği kod) | 15 |
POST /v1/auth/qr/exchange | Okunan QR yükünü okul erişim koduna ve öğretmene çevirir. Gövde: { payload } | 15 |
GET /v1/schools/:id | Okul bilgisi | 15 |
GET /v1/schools/:id/classes | Okulun sınıfları | 23, 25 |
GET /v1/schools/:id/teachers | Okulun öğretmenleri ve branşları | 17, 25 |
GET /v1/teachers/:id | Öğretmen, branşı ve sınıfları | 17, 25 |
GET /v1/teachers/:id/schedule | Öğretmenin haftalık ders programı | 17 |
GET /v1/classes/:id/students | Sınıfın öğrencileri | 27, 30 |
GET /v1/classes/:id/stats | Sınıfın çözülen/doğru/yanlış/boş sayıları. ?lessonId= ?bookId= ?perStudent=1 | 30 |
GET /v1/students/:id/stats | Öğrencinin çözülen/doğru/yanlış/boş sayıları. ?lessonId= ?bookId= | 30 |
GET /v1/lessons | Dersler | 32 |
GET /v1/topics | Konular. ?lessonId= ?grade= | 26, 32 |
GET /v1/sections | Bölüm türleri (orta anlatım, derece anlatım ...) | 32 |
GET /v1/books | Kitaplar, tür ve eş kitap kimliğiyle. ?grade= ?lessonId= ?kind= | 16, 32 |
GET /v1/books/:id | Tek kitap | 16 |
GET /v1/books/:id/questions | Kitabın soru kimlikleri. ?page= ?topicId= ?section= ?limit= ?offset= | 32 |
GET /v1/books/:id/pacing | Müfredat planı: haftaya göre beklenen sayfa aralığı | 23 |
GET /v1/questions/:id | Tek soru ve ikizi | 21, 32 |
GET /v1/questions/:id/stats | Sorunun bir sınıftaki sonucu. ?classId= (zorunlu) | 30 |
GET /v1/students/:id/zero-error | Öğrencinin sıfır hata listesi. ?lessonId= ?bookId= ?status= ?limit= ?offset= | 29 |
GET /v1/classes/:id/zero-error | Sınıfın sıfır hata özeti, öğrenci başına. ?lessonId= ?bookId= | 29 |
GET /v1/classes/:id/twin-errors | İkiz hatalar: hem soruyu hem ikizini yanlış yapan öğrenciler, soru başına. ?lessonId= ?bookId= ?limit= ?offset= | 21 |
POST /v1/classes/:id/progress | Kütüphanem'den Allstar'a: sınıfın kaldığı sayfa. Gövde: { bookId, page, lessonId?, at? } | 23, 25 |
GET /v1/classes/:id/progress | Sınıfın kitap başına kaldığı sayfa ve plana göre farkı. ?week= (1-36) | 23, 25 |