Özellikler
Kelime Öğrenme (WordLearning)
Aralıklı tekrar (spaced repetition) tabanlı, bağımsız kelime öğrenme modülü.
Bir oturum başlatılır, kartlar/quizler oynanır, sonuçlar gönderilerek oturum
bitirilir; backend doğruluk, skor ve tekrar zamanlamasını hesaplar. Tüm
endpointler Bearer ister;
yollar /api/word-learning/... ile başlar.
Kavramlar
| Kavram | Açıklama |
|---|---|
| Session | Bir öğrenme turu. Aktif oturum varsa yeni başlatma aynı oturumu döndürür. |
| Item | Oturumdaki bir öğe: yeni kelime tanıtımı veya zamanı gelmiş tekrar (due review). |
| Word | Kelime içeriği: tanım, bağlam cümlesi, eş anlamlı, görsel. |
| Question / Option | Quiz öğesine ait soru ve cevap seçenekleri. |
| SRS stage / status | Kelimenin aralıklı tekrar kademesi ve öğrenme durumu; doğru/yanlışa göre ilerler, sıfırlanır veya "mastered" olur. |
Sabit değerler (enum)
Bu alanlar sabit bir değer kümesinden gelir — istemci bunları birebir bekleyebilir:
| Alan | Olası değerler |
|---|---|
item.itemType | NewCard (yeni kelime kartı), Quiz |
item.statusCode | Pending, Finished |
item.learningStatus · statusBefore/statusAfter | New, Learning, Review, Reset, Mastered |
oturum statusCode | Active, Completed, Expired |
word.wordType | Noun, Verb, Adjective, Adverb |
question.questionType | ImageMatch, ClosestMeaningWord, ClosestMeaningSentence, FillInTheBlank |
Akış
Oturumu başlat veya devam ettir
POST /api/word-learning/sessions/start
Aktif (süresi dolmamış) oturum varsa aynı snapshot döner; yoksa yeni
kelime/tekrar seçimiyle oturum oluşturulur. Yanıtta oturum bilgisi ve
items (kelime + varsa soru) gelir.
Aktif oturumu oku (opsiyonel)
GET /api/word-learning/sessions/current — uygulamaya geri dönüşte mevcut oturumu yükler.
Oturumu bitir
POST /api/word-learning/sessions/{sessionIdentifier}/finish
İstek gövdesi{
"clientAttemptIdentifier": "<istemci deneme kimliği>",
"items": [
{
"sessionItemIdentifier": "<öğe GUID>",
"selectedOptionIdentifier": "<seçenek GUID veya null>",
"didRevealAnswer": false
}
]
}
Doğruluk, skor ve SRS geçişleri (advancedWordCount,
resetWordCount, masteredWordCount,
nextReviewOnUtc) backend tarafından hesaplanır.
dailyNewWordQuota /
newWordCountUsedToday) dikkate alır. Bitirme isteği
clientAttemptIdentifier ile idempotenttir; aynı deneme tekrar
gönderilirse isIdempotentReplay: true döner ve state ikinci kez değişmez.