Özellikler

Mini Oyunlar (MiniGames)

Sınıf seviyesine göre açılan, oyun başına seviye ilerlemesi olan mini oyunlar. Erişim, günlük oyun oturumunun tamamlanmasına bağlıdır. Tüm endpointler Bearer ister; yollar /api/mini-games/... ile başlar.

Kavramlar

KavramAçıklama
KatalogKullanıcının grade'i için mini oyun listesi ve her oyunun kullanıcı durumu.
Oynanabilirlik gate'iisUnlocked, isDailySessionCompleted, isEnabledForGrade birlikte isPlayable'ı belirler.
Seviye ilerlemesiHer oyunun kendi currentLevel/maxLevel ve bestScore değeri.

Mini oyun kodları (miniGameCode)

GET /api/mini-games yalnız aktif mini oyunları döndürür. POST /api/mini-games/{miniGameCode}/complete isteğinde bu kodlardan biri kullanılır.

miniGameCodeKatalog adı
VisualMemoryVisual Memory
ShortTermMemoryShort Term Memory
PeripheralVisionPeripheral Vision
SharpVisionSharp Vision
SynonymWordsSynonym Words
AntonymWordsAntonym Words
TreasureHuntingTreasure Hunting
ShapeMatchingShape Matching
ShapeCountingShape Counting

Katalogda pasif duran WordCatch, WordLearning ve ShortStories listede dönmez. Ödül para birimi varsayılan yapılandırmada Credits'tir.

Akış

1

Listeyi ve durumu oku

GET /api/mini-games

Katalog + oynanabilirlik gate'i + kullanıcı level state'i döner. isPlayable=false ise (ör. günlük oturum bitmemiş) oyun başlatılmamalıdır.

2

Oyunu tamamla

POST /api/mini-games/{miniGameCode}/complete

İstek gövdesi
{
  "clientAttemptIdentifier": "<istemci deneme kimliği>",
  "attemptedLevel": 3,
  "score": 850,
  "durationSeconds": 42
}

Backend; başarı eşiğini, seviye atlamayı (didLevelUp, levelBefore/levelAfter) ve küçük bir Credits ödülünü (rewardCreditAmount) belirler. Ödül, ödül akışıyla (pending → claim) alınır.

Günlük gate ve idempotency Tamamlama, günlük oyun oturumu tamamlanmış olmasını gerektirir. İstek clientAttemptIdentifier ile idempotenttir; aynı deneme tekrar gönderilirse isIdempotentReplay: true döner.
Günlük görevlerle ilişkisi Her yeni deneme, başarısız olsa da, "2 farklı mini oyun oyna" görevini ilerletir (aynı oyun görev başına bir kez sayılır; replay sayılmaz). Seviye atlayan deneme ayrıca "1 mini oyun seviyesi geç" görevini ilerletir. Bkz. Gamification.
Alan bazlı tam şema Request/response alanlarının tamamı İnteraktif API Referansı'nda (MiniGames bölümü) yer alır.