Ö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

KavramAçıklama
SessionBir öğrenme turu. Aktif oturum varsa yeni başlatma aynı oturumu döndürür.
ItemOturumdaki bir öğe: yeni kelime tanıtımı veya zamanı gelmiş tekrar (due review).
WordKelime içeriği: tanım, bağlam cümlesi, eş anlamlı, görsel.
Question / OptionQuiz öğesine ait soru ve cevap seçenekleri.
SRS stage / statusKelimenin 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:

AlanOlası değerler
item.itemTypeNewCard (yeni kelime kartı), Quiz
item.statusCodePending, Finished
item.learningStatus · statusBefore/statusAfterNew, Learning, Review, Reset, Mastered
oturum statusCodeActive, Completed, Expired
word.wordTypeNoun, Verb, Adjective, Adverb
question.questionTypeImageMatch, ClosestMeaningWord, ClosestMeaningSentence, FillInTheBlank

Akış

1

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.

2

Aktif oturumu oku (opsiyonel)

GET /api/word-learning/sessions/current — uygulamaya geri dönüşte mevcut oturumu yükler.

3

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.

Günlük kota ve idempotency Oturum, günlük yeni kelime kotasını (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.
Alan bazlı tam şema Request/response alanlarının tamamı İnteraktif API Referansı'nda (WordLearning bölümü) yer alır.