Diğer uç noktalar

Uç noktalar

Ortak kurallar

• İstekleri Kimlik doğrulama sayfasındaki gibi imzalayın. Yazma isteklerinde (PUT, POST) X-Request-Id de zorunludur.
• site_id her yerde site kodudur, örn. site_mrd01. Siteye bağlı anahtar yalnız kendi sitesini görür ve yalnız kendi sitesine yazar.
• Yanıttaki tutarlar iki ondalıklı JSON sayısıdır, örn. 0.20.
• Ortak veri Test ve Canlı’da aynıdır: Test anahtarıyla yaptığınız değişiklik Canlı’da da geçerli olur. Bkz. Ortamlar.
• Her imzalı uçta dönebilen hatalar (INVALID_SIGNATURE, TIMESTAMP_SKEW, IP_NOT_ALLOWED, SCOPE_MISSING, RATE_LIMITED, yazmada X-Request-Id için 422 ve 409) Hata kodları sayfasındadır. Bu sayfaya özgü kodlar en alttaki tablodadır.

Etkin limitler

GET /v1/limits · kapsam games.read. Bir oyunun sitede launch’ta alacağı limitleri döndürür: tüm kurallar ve pazar tavanı uygulanmış hâli.

{
  "currency": "USD",
  "min_bet": 0.20,
  "max_bet": 50.00,
  "default_bet": 1.00,
  "source": { "min_bet": "platform", "max_bet": "site" }
}

Limit sırası

Katmanlar yukarıdan aşağı uygulanır. Her katman yalnız üstündeki aralığı daraltabilir: min_bet yalnız artar, max_bet yalnız azalır. Aralığı boşaltacak katman yok sayılır. default_bet onu belirleyen son katmandan gelir ve aralığa sığdırılır; hiçbir katman belirlemezse min_bet olur. Platform katmanlarını Boss Hub yönetir, operatör ve site katmanları sizindir.

Limit kurallarınız

GET /v1/limits/rules · kapsam games.read. Parametre almaz. Operatörünüzün ve sitelerinizin limit kurallarını döndürür: önce operatör, sonra site kuralları. Platform kuralları listelenmez. Site anahtarı yalnız kendi sitesinin kurallarını görür.

Limit kuralı yazma

PUT /v1/limits/rules · kapsam limits.write. Tek kural yazar: bir hedef, bir seviye (operatör veya site), bir para birimi. Kural yoksa açılır, varsa güncellenir. Yanıt {"changed": true}; değişen bir şey yoksa false.

{
  "scope": "game",
  "ref": "sultans-ember",
  "site_id": "site_mrd01",
  "currency": "USD",
  "min_bet": 0.20,
  "max_bet": 50.00,
  "default_bet": 1.00
}

Açık/kapalı durumu

GET /v1/availability · kapsam games.read. Size açık her sağlayıcının ve oyunlarının site bazında çözülmüş durumunu döndürür. Launch ile aynı denetimdir ve anahtarınızın ortamında çalışır.

[
  { "scope": "provider", "ref": "boss-originals", "site_id": "site_mrd01", "enabled": true, "source": null },
  { "scope": "game", "ref": "sultans-ember", "site_id": "site_mrd01", "enabled": false, "source": "operator_rule" }
]

Açma ve kapama kuralı

PUT /v1/availability/rules · kapsam availability.write. Bir sağlayıcı veya oyun için kararınızı yazar: operatör geneli veya tek site. Yanıt {"changed": true}; durum zaten aynıysa false.

Lobi kategorileri

GET /v1/lobby/categories · kapsam games.read. Lobi kategorilerini sırasıyla döndürür.

[
  {
    "key": "featured",
    "name": { "tr": "Öne çıkanlar", "en": "Featured" },
    "mode": "manual",
    "auto_rule": null,
    "games": ["sultans-ember", "cyber-djinn"]
  },
  {
    "key": "new",
    "name": { "tr": "Yeni oyunlar", "en": "New games" },
    "mode": "auto",
    "auto_rule": "new_30d",
    "games": ["cyber-djinn"]
  }
]

Lobi kategorilerini kaydetme

PUT /v1/lobby/categories · kapsam lobby.write. Gövde kategorilerin tam listesidir (JSON dizi) ve hedef kümenin tamamını değiştirir: operatör geneli veya site_id sitesi. Listedeki sıra lobideki sıradır. Yanıt kaydedilen kümedir, GET biçiminde.

Pazarlama materyalleri

GET /v1/marketing/assets · kapsam marketing.read. Kütüphanenizdeki oyunların materyal paketlerini listeler. Duyurulan bir oyunun paketi çıkıştan 14 gün önce görünür.

[
  {
    "game_id": "sultans-ember",
    "zip_url": "https://api.example.com/…/packs/sultans-ember.zip?op=…&exp=1762344900&sig=…",
    "files": [
      {
        "kind": "banner",
        "size": "1920x600",
        "locale": null,
        "name": "sultans-ember_banner_1920x600.png",
        "url": "https://api.example.com/media/fil_01HF3K9QZ2.png"
      },
      {
        "kind": "copy",
        "size": null,
        "locale": "en",
        "name": "sultans-ember_copy_en.txt",
        "url": null
      }
    ]
  }
]

Günlük mutabakat

GET /v1/reconciliation/daily · kapsam reconciliation.read. Bir UTC günü için bizim toplamlarımızı sizin gönderdiklerinizle karşılaştırır; para birimi başına bir satır döner. Yalnız operatör anahtarı: site anahtarı 403 SCOPE_DENIED alır.

[
  {
    "date": "2026-11-05",
    "currency": "USD",
    "provider_side": { "bets": 51240.00, "wins": 49190.40, "rounds": 19377, "transactions": 39102 },
    "operator_side": { "bets": 51240.00, "wins": 49185.40, "rounds": 19377, "transactions": null },
    "difference": -5.00,
    "status": "mismatch"
  }
]

Günlük toplam gönderme

POST /v1/reconciliation/daily?date=YYYY-MM-DD · kapsam reconciliation.write. Bir gün ve para birimi için kendi toplamlarınızı gönderirsiniz. Yanıt karşılaştırılmış satırdır: 200, yukarıdaki biçimde tek nesne. Aynı gün ve para birimine yeniden göndermek önceki toplamınızın yerine geçer ve portalda elle kapatılmış farkı yeniden açar. Yalnız operatör anahtarı.

{
  "currency": "USD",
  "bets": 51240.00,
  "wins": 49185.40,
  "rounds": 19377
}

Cüzdan sağlığı

GET /v1/wallet-health · kapsam wallet_health.read. Cüzdanınıza gönderdiğimiz callback’lerin performansını, anahtarınızın ortamında döndürür. Test paketi ve bağlantı testi çağrıları sayılmaz. Durum eşikleri hesabınızın cüzdan alarm kurallarından, yoksa platform varsayılanından gelir.

{
  "p50_ms": 75,
  "p95_ms": 250,
  "error_rate": 0.0004,
  "timeout_rate": 0.0001,
  "by_call": [
    { "call": "authenticate", "count": 1204, "p95_ms": 150, "error_rate": 0 },
    { "call": "balance", "count": 3310, "p95_ms": 125, "error_rate": 0 },
    { "call": "bet", "count": 18420, "p95_ms": 250, "error_rate": 0.0005 },
    { "call": "win", "count": 6120, "p95_ms": 200, "error_rate": 0.0002 },
    { "call": "rollback", "count": 12, "p95_ms": 300, "error_rate": 0 }
  ],
  "hourly": [
    { "hour": "2026-11-04T15:00:00.000Z", "status": "ok" },
    { "hour": "2026-11-04T16:00:00.000Z", "status": "warn" }
  ]
}

Canlı akış

GET /v1/live/stream · kapsam rounds.read · live modülü. Turlarınızı kapandıkça gönderen Server-Sent Events akışıdır (text/event-stream), anahtarınızın ortamında. İsteği her GET gibi imzalayın; bağlantı sonra açık kalır.

: ok

event: round.closed
data: {"id":"rnd_01HF3K9QZ2","site_id":"site_mrd01","player_id":"u_88213","game_id":"sultans-ember","currency":"USD","bet":2.00,"win":150.00,"status":"closed","kind":"normal","has_jackpot":false,"closed_at":"2026-11-05T14:22:09.000Z"}

event: round.big_win
data: {"id":"rnd_01HF3K9QZ2","site_id":"site_mrd01","player_id":"u_88213","game_id":"sultans-ember","currency":"USD","bet":2.00,"win":150.00,"status":"closed","kind":"normal","has_jackpot":false,"closed_at":"2026-11-05T14:22:09.000Z"}

: ping

Oyuncu olayları

POST /v1/player-events · kapsam player_events.write. İsteğe bağlıdır. Bu ortamda daha önce oyun açmış bir oyuncu için yatırım, çekim veya sinyal kaydeder. Yanıt 201 ve olay kimliğidir. Olay göndermezseniz aşağıdaki ölçümler boş kalır.

{
  "player_id": "u_88213",
  "site_id": "site_mrd01",
  "type": "deposit",
  "amount": "25.00",
  "currency": "USD",
  "occurred_at": "2026-11-05T14:30:00Z"
}

{
  "id": "pev_01HF3Q2M8V"
}

Hata kodları