Test Araçları
TestOps (Data Manipulation)
Unity tarafının testlerini hızlandırmak için kullanıcı verisini doğrudan
ayarlayan yardımcı endpointler: wallet/XP değiştir, sandık ver, günlük oturumu
sıfırla veya belirli içerikle zorla, mini oyun seviyesini ayarla, feed satırı
ekle/düzenle, cihaza test bildirimi gönder. Yollar /api/test-ops/... ile başlar.
TestOps:IsEnabled = true
olduğunda çalışır. Her işlem bir denetim (audit) kaydı üretir
(yanıttaki auditIdentifier).
Kimlik doğrulama: API anahtarı
TestOps bearer token kullanmaz. Her isteğe şu başlık eklenir:
X-TestOps-Key: <anahtar>
Anahtar sunucu konfigürasyonundan gelir: TestOps:ApiKey
(appsettings / ortam değişkeni). Anahtarı ekipten/ortam ayarından al; bu
sayfada gerçek değeri yazılı değildir. Yanlış/eksik anahtar reddedilir.
Kullanıcı tanımlayıcısı
Yol parametresi {userIdentifier} şunlardan biri olabilir:
ID (sayısal), benzersiz ID (GUID),
e-posta veya kullanıcı adı.
İşlemler
| İşlem | Endpoint | Ne yapar |
|---|---|---|
| Wallet ayarla | POST /users/{userIdentifier}/wallet/adjust | Bakiyeye +/- adjustment uygular |
| XP ayarla | POST /users/{userIdentifier}/xp/adjust | Toplam XP'yi değiştirir (reward hook tetiklemez) |
| Sandık ver | POST /users/{userIdentifier}/rewards/loot-box | Claim edilebilir (pending) loot box ödülü oluşturur |
| Günlük oturum sıfırla | POST /users/{userIdentifier}/daily-session/reset | Bugünkü oturum ilerlemesini sıfırlar |
| Günlük oturum zorla | POST /users/{userIdentifier}/daily-session/force | Belirli template/framework kodlarından oturum kurar |
| Mini oyun sıfırla | POST /users/{userIdentifier}/mini-games/{miniGameCode}/reset | İlgili mini oyunun seviye/sayaçlarını sıfırlar |
| Mini oyun seviyesi | POST /users/{userIdentifier}/mini-games/{miniGameCode}/level | Mini oyun seviyesini ayarlar |
| Feed ekle | POST /users/{userIdentifier}/feed | Sınıf feed'ine manuel satır ekler |
| Feed düzenle | PATCH /feed/{feedItemIdentifier} | Feed satırını günceller (gönderilen alanlar) |
| Feed pasifleştir | DELETE /feed/{feedItemIdentifier} | Satırı silmez, pasifleştirir |
| Etkinlik koşusunu sıfırla | POST /events/{eventIdentifier}/users/{userIdentifier}/reset | Öğrencinin koşusunu iptal eder; sıralamadan çıkar, hakkı 1'e döner |
| Etkinlik aralığı | POST /events/{eventIdentifier}/window | Başlangıç/bitişi değiştirir; bitişi geçmişe çekmek etkinliği bitirir ve ödülleri sınar |
| Test bildirimi | POST /users/{userIdentifier}/push-test | Öğrencinin kayıtlı cihazlarına verilen başlık/metinle gerçek bir push bildirimi gönderir |
MaxWalletAdjustmentAbs,
MaxXpAdjustmentAbs, MaxLootBoxQuantity,
MaxForcedDailySessionItems. Sınırı aşan (veya 0 olan) wallet/XP
değişimi InvalidWalletAdjustment / InvalidXpAdjustment,
aralık dışı sandık adedi InvalidLootBoxQuantity ile döner. Zorlanan
oturumda MaxForcedDailySessionItems üstündeki şablonlar hata vermez;
oturuma alınmaz.
Günlük oturumu zorlama (force)
Deterministik test için bugünün günlük oyun oturumunu istediğin oyun
çerçeveleriyle (framework) kurar. frameworkCodes veya
templateCodes verilir.
{
"replaceTodaySession": true,
"frameworkCodes": ["MCQ", "IMAGE_CHOICE", "DRAG_MATCH"],
"requestedWorkloadUnits": 3,
"reason": "unity smoke test"
}
Kullanılabilir frameworkCodes değerleri
Geçerli framework kodları (GameTemplateFrameworkCodes):
| Kod | Kısa açıklama |
|---|---|
MCQ | Çoktan seçmeli |
EVIDENCE_SELECT | Kanıt/dayanak seçme |
WORD_SELECT | Kelime seçme |
SENTENCE_SELECT | Cümle seçme |
IMAGE_CHOICE | Görsel seçme |
MULTI_SOURCE | Çoklu kaynak |
MULTI_CHOICE | Çoklu seçim |
SCAN_SELECT | Tarayarak seçme |
FLOATING_SELECT | Akan/uçuşan öğe seçme |
MORPH_SPLIT | Kök/ek (morfolojik) ayırma |
SENTENCE_ORDER | Cümle sıralama |
PARAGRAPH_ORDER | Paragraf sıralama |
DRAG_MATCH | Sürükle-eşleştir |
TIMELINE_ORDER | Zaman çizelgesi sıralama |
TABLE_FILL | Tablo doldurma |
Not: frameworkCodes ve templateCodes ikisi de boşsa
InvalidDailySessionSelection, kullanıcının sınıfına uyan aktif şablon
bulunamazsa GameTemplatesNotFound, bugünün oturumu zaten varken
replaceTodaySession=false gönderilirse DailySessionAlreadyExists
döner. Zorlanan oturumun ögelerinde selectionReason ve oturumun
selectionPolicyVersion değeri TestOpsForcedDailySession olur.
Test bildirimi (push)
Öğrencinin kayıtlı cihazlarına (bkz. Push Bildirimleri)
verilen başlık ve metinle gerçek bir bildirim gönderir. İstek bildirimi yalnız kuyruğa alır;
gönderim birkaç saniye içinde normal bildirimlerle aynı yoldan yapılır. Bildirimin
notificationType değeri push.smoke'tur ve günlük 2 bildirim
sınırına sayılmaz.
{
"title": "Merhaba 👋",
"body": "Bu bir test bildirimidir.",
"reason": "ios cihaz testi"
}
| Alan | Kural |
|---|---|
title | Zorunlu, en fazla 65 karakter (baştaki/sondaki boşluklar kırpılır). |
body | Zorunlu, en fazla 180 karakter. |
reason | İsteğe bağlı; denetim kaydına yazılır. |
Yanıtta dispatchIdentifier (bildirimin ID'si), öğrencinin gönderime uygun cihaz
sayısı (deliverableInstallationCount) ve isQuietHours döner.
isQuietHours = true ise istek 23:00–07:30 (İstanbul) arasında gelmiştir; bildirim
07:30'da gönderilir.
TestOps:PushUserIdentifiers listesinde olan
öğrencilere gönderilebilir; diğerleri PushTestUserNotAllowed ile döner. Öğrencinin
aktif, bildirim izni verilmiş ve son 30 günde görülmüş bir cihazı yoksa
NoDeliverableInstallation döner. Sunucuda push gönderimi kapalıysa istek yine
başarılı döner ama bildirim cihaza ulaşmaz.
Örnek çağrı
cURL — wallet'a +500 Creditscurl -X POST "<api>/api/test-ops/users/ogrenci1/wallet/adjust" \
-H "X-TestOps-Key: <anahtar>" \
-H "Content-Type: application/json" \
-d '{"currencyCode":"Credits","amount":500,"reason":"test"}'