Başlarken/Genel bakış
Genel bakış
Boss Hub, kendi Boss Originals oyunlarını ve bağlı sağlayıcıları tek platformda sunan B2B oyun altyapısıdır. Tek bir Seamless Wallet entegrasyonuyla tüm kataloğa erişirsiniz; bakiye sizde kalır, her para hareketi imzalı bir callback ile cüzdanınıza işlenir.
İki yön
| Yön | Ne için | Sayfa |
|---|---|---|
| Operatör → Boss Hub | REST API: oyun listesi, oyun başlatma, tur ve işlem sorgulama, free round, jackpot, GGR raporları | Sağlayıcı API |
| Boss Hub → Operatör | Seamless Wallet callback’leri: authenticate, balance, bet, win, rollback | Seamless Wallet |
| Boss Hub → Operatör | Olay bildirimleri: büyük kazanç, takılı tur, fatura, yeni oyun ve diğerleri | Webhook olayları |
Bir turun akışı
Operatör ── POST /v1/game/launch ──▶ Boss Hub Boss Hub ── launch_url, session_id ─▶ Operatör Oyuncu ── launch_url ─────────────▶ Boss Hub ── /authenticate ──▶ Operatör Oyun ── tur ────────────────────▶ Boss Hub ── /bet, /win, /rollback ──▶ Operatör Boss Hub ── webhook olayları ───────▶ Operatör
- POST /v1/game/launch ile oyuncu için oturum açarsınız; yanıtta tek kullanımlık launch_url gelir.
- Oyuncu bu adresi açtığında Boss Hub, token’ı authenticate ile size doğrulatır ve oyunu başlatır.
- Her turda bet bakiyeyi düşürür, win kazancı ekler. Bahis yanıtı alınamazsa rollback gider.
- Sonuçları GET /v1/rounds ve GET /v1/reports/ggr ile sorgular, önemli olayları webhook ile alırsınız.
Temel kurallar
- Bakiye sizde kalır. Boss Hub bakiye tutmaz. Desteklenen cüzdan modeli Seamless Wallet’tır.
- Her istek imzalıdır. İki yönde de HMAC-SHA256 kullanılır. Ayrıntı: Kimlik doğrulama & imza.
- Cüzdan çağrıları idempotent’tir. Aynı transaction_id ile gelen tekrar, ilk işlenmiş sonucu aynen almalıdır.
- Kimlikler önek ve 26 karakterli ULID’dir (rnd_01M753KW12T4EMPVCZQB1C6YMC); işlem kimliğine -b1 gibi ek gelir. Örneklerde kısaltılmıştır. Kimlikleri ayrıştırmayın, metin olarak saklayın.
- İş kuralı hataları HTTP 200 ile döner. Gövdede status: ERROR ve code bulunur. Ayrıntı: Hata kodları.
- Tutarlar iki ondalıklı JSON sayısıdır, örn. 148.60. Para birimleri USD, EUR, TRY. Ayrıntı: Para birimleri & diller.
- İki ortam vardır: Test (staging) ve Canlı (production); her birinin kendi API adresi vardır ve portalda Entegrasyon & API sayfasında gösterilir. Canlı’da IP izin listesi zorunludur. Ayrıntı: Ortamlar & IP allowlist.
Nereden başlamalı
Entegrasyona Hızlı başlangıç ile başlayın. Para güvenliği kuralları için önce bet, win ve rollback sayfalarını okuyun. Canlıya geçmeden önce test paketinin 42 senaryosunun tamamı geçmelidir.