Başlarken/Hızlı başlangıç

Hızlı başlangıç

Test anahtarından canlıya dört adım: anahtarı alın, callback’leri bağlayın, test paketini çalıştırın, canlıya geçin. Örnek kodlarda BOSS_API_URL, portalda Entegrasyon & API sayfasında seçili ortam için gösterilen API adresidir; BOSS_SECRET imza secret’ınızdır.

1. Anahtar alın

Hesabınız açılınca Test API anahtarı kendiliğinden oluşur. Portala girin (adresi hesabınız açılırken iletilir; önce e-postanıza gelen erişim kodu, sonra Boss Hub girişi), üst çubukta Test seçin ve Geliştirici › Entegrasyon & API sayfasını açın. Secret yalnızca bir kez, ilk görüntülemede gösterilir; kaybettiyseniz döndürün.

Bilgi	Örnek	Nerede kullanılır
Operatör ID	op_meridyen	X-Operator-Id başlığı
Site kodu	site_mrd01	Birden çok siteniz varsa istek gövdesindeki site_id
API anahtarı	pk_test_••••8f2a	İsteğe bağlı X-Api-Key başlığı
İmza secret’ı	••••••••	X-Signature hesabı, bkz. Kimlik doğrulama & imza

2. Callback’leri bağlayın

Portalda Uç noktalar & cüzdan kartının Callback base URL alanına adresinizi girin, örn. https://staging-api.meridyen.example/bossgaming. Boss Hub beş yolu bu adrese ekler; adres sorgu dizesi içermez ve /bet gibi bir çağrı adıyla bitmez. Bağlantıyı test et beş yolun hepsini para etkisi olmadan dener (geçersiz token, bilinmeyen test oyuncusu, sıfır tutarlı ve geri alınmış test kimlikleri) ve her yolun sonucunu gösterir; 200 dışı yanıt, INVALID_SIGNATURE ya da para birimi tutmayan OK başarısız sayılır. Callback’leriniz Boss Hub çıkış IP’lerinden gelir; adresler IP izin listesi kartındadır.

Yol	Görev	Sayfa
/authenticate	Oyuncu token’ını doğrular; oyuncu ve bakiyeyi döner	authenticate
/balance	Güncel bakiyeyi döner	balance
/bet	Bahsi bakiyeden düşer	bet
/win	Kazancı bakiyeye ekler	win
/rollback	Bahsi veya kazancı geri alır	rollback

Üç kural: Yanıtı 3 sn içinde, her zaman HTTP 200 ile verin (hata da status: ERROR + code). Aynı transaction_id aynı gövdeyle gelirse ilk sonucu aynen döndürün, farklı gövdeyle gelirse DUPLICATE_TRANSACTION dönün. Bilinmeyen rollback’e OK deyip kaydedin.

Bir oyun açın

Callback’ler hazır olunca Test ortamında oyun oturumu açarak akışı uçtan uca deneyin. game_id değerini oyun listesinden (GET /v1/games), para birimini sitenizin desteklediklerinden seçin. Dönen launch_url tek kullanımlıktır ve varsayılan olarak 60 sn geçerlidir. Tüm alanlar: Oyun başlatma.

BODY='{"game_id":"10-burning-heart","site_id":"site_mrd01","player_id":"u_88213","token":"tok_8f2a6c41","currency":"TRY","language":"tr"}'
TS=$(date +%s)
SIG=$(printf '%s' "$TS.POST./v1/game/launch.$BODY" | openssl dgst -sha256 -hmac "$BOSS_SECRET" -hex | awk '{print $NF}')

curl -X POST "$BOSS_API_URL/v1/game/launch" \
  -H "Content-Type: application/json" \
  -H "X-Operator-Id: op_meridyen" \
  -H "X-Timestamp: $TS" \
  -H "X-Signature: $SIG" \
  -H "X-Request-Id: launch-$TS-$RANDOM" \
  -d "$BODY"

200Oturum açıldı

{
  "launch_url": "https://api.example.com/s/7Hq…",
  "session_id": "ses_01HF3K7M",
  "expires_in": 60,
  "limits": {
    "currency": "TRY",
    "min_bet": 1.00,
    "max_bet": 500.00,
    "default_bet": 5.00,
    "source": { "min_bet": "provider", "max_bet": "provider" }
  }
}

3. Test paketini çalıştırın

Önce Test’te bir sağlayıcı ekleyin: üst çubukta Test seçiliyken Oyun › Sağlayıcılar sayfasında size açılan sağlayıcıda Ekle deyin. Paketin motor senaryoları (ERR, TMO-02, RND, REQ-01) size Test’te açık bir oyunda gerçek bir test turu oynar; açık oyun yoksa bu senaryolar YAPILMADI kalır ve canlıya geçiş kilitli kalır.

Portalda Entegrasyon test paketi kartında önce Test verilerini girin (test oyuncusu, uzun ömürlü geçerli token, süresi dolmuş token, engelli ve limitli oyuncu), sonra Tekrar çalıştır deyin. Paket; zaman aşımı, tekrar ve yetersiz bakiye dahil 42 senaryoyu gerçek Test cüzdanınıza karşı çalıştırır. Sonuç portal bildirimi ve e-postayla gelir. Liste: Test paketi senaryoları.

4. Canlıya geçin

En son test koşusu 42/42 GEÇTİ olmalıdır; UYARI da engeller.
Üst çubukta Canlı seçin ve IP izin listesine en az bir adres ekleyin; liste boşken Canlı istekleri reddedilir.
Production iste deyin; Boss Hub şirket belgelerinizi ve en son test koşusunu yeniden denetleyip isteği onaylar. Talep tarihi, onay ya da ret nedeni Canlıya geçiş kartında görünür; reddedilen talebi düzeltip yeniden gönderin.
Onaydan sonra Canlı anahtarınızı (pk_live_) açın, Canlı callback adresinizi girin, sitenizi Canlı yapın ve BOSS_API_URL’i portalda Canlı seçiliyken gösterilen API adresine çevirin. Ayrıntı: Canlıya geçiş.

Sağlayıcı bazında: Bir sağlayıcının Canlıya al düğmesi, en son test koşusu tam geçince açılır; Canlı’da yalnız canlıya alınmış sağlayıcıların oyunları açılır. Ayrıntı: Ortamlar & IP allowlist.

← ÖncekiGenel bakış Sonraki →Kimlik doğrulama & imza