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.

Yalnızca test/debug ortamı Bu yüzey üretim (production) istemcisi için değildir; sadece test/geliştirme amaçlıdır. Sunucuda 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

İşlemEndpointNe yapar
Wallet ayarlaPOST /users/{userIdentifier}/wallet/adjustBakiyeye +/- adjustment uygular
XP ayarlaPOST /users/{userIdentifier}/xp/adjustToplam XP'yi değiştirir (reward hook tetiklemez)
Sandık verPOST /users/{userIdentifier}/rewards/loot-boxClaim edilebilir (pending) loot box ödülü oluşturur
Günlük oturum sıfırlaPOST /users/{userIdentifier}/daily-session/resetBugünkü oturum ilerlemesini sıfırlar
Günlük oturum zorlaPOST /users/{userIdentifier}/daily-session/forceBelirli template/framework kodlarından oturum kurar
Mini oyun sıfırlaPOST /users/{userIdentifier}/mini-games/{miniGameCode}/resetİlgili mini oyunun seviye/sayaçlarını sıfırlar
Mini oyun seviyesiPOST /users/{userIdentifier}/mini-games/{miniGameCode}/levelMini oyun seviyesini ayarlar
Feed eklePOST /users/{userIdentifier}/feedSınıf feed'ine manuel satır ekler
Feed düzenlePATCH /feed/{feedItemIdentifier}Feed satırını günceller (gönderilen alanlar)
Feed pasifleştirDELETE /feed/{feedItemIdentifier}Satırı silmez, pasifleştirir
Etkinlik koşusunu sıfırlaPOST /events/{eventIdentifier}/users/{userIdentifier}/resetÖğrencinin koşusunu iptal eder; sıralamadan çıkar, hakkı 1'e döner
Etkinlik aralığıPOST /events/{eventIdentifier}/windowBaşlangıç/bitişi değiştirir; bitişi geçmişe çekmek etkinliği bitirir ve ödülleri sınar
Test bildirimiPOST /users/{userIdentifier}/push-testÖğrencinin kayıtlı cihazlarına verilen başlık/metinle gerçek bir push bildirimi gönderir
Konfigüre üst sınırlar Değişimler sunucu config'iyle sınırlıdır: 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.

İstek gövdesi
{
  "replaceTodaySession": true,
  "frameworkCodes": ["MCQ", "IMAGE_CHOICE", "DRAG_MATCH"],
  "requestedWorkloadUnits": 3,
  "reason": "unity smoke test"
}

Kullanılabilir frameworkCodes değerleri

Geçerli framework kodları (GameTemplateFrameworkCodes):

KodKısa açıklama
MCQÇoktan seçmeli
EVIDENCE_SELECTKanıt/dayanak seçme
WORD_SELECTKelime seçme
SENTENCE_SELECTCümle seçme
IMAGE_CHOICEGörsel seçme
MULTI_SOURCEÇoklu kaynak
MULTI_CHOICEÇoklu seçim
SCAN_SELECTTarayarak seçme
FLOATING_SELECTAkan/uçuşan öğe seçme
MORPH_SPLITKök/ek (morfolojik) ayırma
SENTENCE_ORDERCümle sıralama
PARAGRAPH_ORDERParagraf sıralama
DRAG_MATCHSürükle-eşleştir
TIMELINE_ORDERZaman çizelgesi sıralama
TABLE_FILLTablo 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.

İstek gövdesi
{
  "title": "Merhaba 👋",
  "body": "Bu bir test bildirimidir.",
  "reason": "ios cihaz testi"
}
AlanKural
titleZorunlu, en fazla 65 karakter (baştaki/sondaki boşluklar kırpılır).
bodyZorunlu, 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.

Yalnız test listesindeki öğrenciler Bildirim yalnız sunucudaki 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 Credits
curl -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"}'
Alan bazlı tam şema Tüm request/response alanları İnteraktif API Referansı'nda (TestOps bölümü) yer alır.