Sağlayıcı API/İşlem akışı

İşlem akışı

API · Operatör → Boss Hub

GET/v1/transactions

Cüzdanınıza gönderilen bahis, kazanç ve rollback işlemlerini zaman sırasıyla döndürür: kendi cüzdan kaydınızla işlem işlem karşılaştırmak ve işlem kimliğinden tura ulaşmak için. Yalnız kendi işlemlerinizi, anahtarınızın ortamında görürsünüz. rounds.read kapsamı gerekir.

Başlıklar

Başlık	Açıklama
X-Operator-Id	Operatör kimliğiniz
X-Timestamp	Unix saniye. ±30 sn dışı reddedilir
X-Signature	hex(HMAC_SHA256(secret, ts + "." + METHOD + "." + path?query + "." + body))
X-Api-Key	İsteğe bağlı. Birden çok anahtarınız varsa doğru secret’ı seçer

Sorgu parametreleri

fromdate-timezorunlu

Başlangıç zamanı, dahil (created_at).

todate-timezorunlu

Bitiş zamanı, dahil değil. Aralık en çok 31 gün.

site_idstring

Site kodu, örn. site_mrd01, en çok 64 karakter. Site anahtarında yalnız kendi siteniz.

player_idstring

Operatör tarafındaki oyuncu kimliği, en çok 100 karakter. Bilinmeyen oyuncuda sayfa boş döner.

round_idstring

Tur kimliği, örn. rnd_01HF3K9QZ2, en çok 64 karakter. Geçersiz biçimde sayfa boş döner.

transaction_idstring

Cüzdan çağrısındaki işlem kimliği, en çok 80 karakter: işlemden tura ulaşmak için. Geçersiz biçimde sayfa boş döner.

typestring

bet, win, rollback.

cursorstring

Önceki yanıttaki next_cursor değeri.

limitinteger

Sayfa boyutu: 1-1000, varsayılan 100.

Sayfalama: Sıra created_at, sonra transaction_id artan. next_cursor doluysa aynı sorguyu cursor ile tekrar edin; null ise son sayfadasınız. Kapanmış bir aralığı baştan sona okumak satırları bir kez ve sırayla verir.

İşaretler: round_closed, is_freeround, campaign_id, jackpot, promo cüzdan çağrısında size giden değerlerdir ve sonradan değişmez. Rollback satırında jackpot ve promo geri alınan işlemden gelir; round_closed rollback’te false. Turun güncel durumu için tur sorgulama.

GET /v1/transactions?from=2026-11-05T00:00:00Z&to=2026-11-06T00:00:00Z&limit=500 HTTP/1.1
Host: staging.example.com
X-Operator-Id: op_meridyen
X-Timestamp: 1762344000
X-Signature: 3b91d0…7a2c

200İşlemler

{
  "items": [
    {
      "transaction_id": "tx_01HF3K9QZ2-b1",
      "round_id": "rnd_01HF3K9QZ2",
      "type": "bet",
      "amount": 2.00,
      "currency": "USD",
      "status": "ok",
      "round_closed": false,
      "is_freeround": false,
      "campaign_id": null,
      "jackpot": null,
      "promo": null,
      "ref_transaction_id": null,
      "operator_tx_id": "op_tx_9921844",
      "player_id": "u_88213",
      "game_id": "sultans-ember",
      "site_id": "site_mrd01",
      "created_at": "2026-11-05T14:22:05Z",
      "completed_at": "2026-11-05T14:22:05Z"
    },
    {
      "transaction_id": "tx_01HF3K9QZ2-w1",
      "round_id": "rnd_01HF3K9QZ2",
      "type": "win",
      "amount": 5.00,
      "currency": "USD",
      "status": "ok",
      "round_closed": true,
      "is_freeround": false,
      "campaign_id": null,
      "jackpot": null,
      "promo": null,
      "ref_transaction_id": null,
      "operator_tx_id": "op_tx_9921845",
      "player_id": "u_88213",
      "game_id": "sultans-ember",
      "site_id": "site_mrd01",
      "created_at": "2026-11-05T14:22:09Z",
      "completed_at": "2026-11-05T14:22:09Z"
    }
  ],
  "next_cursor": "eyJhdCI6IjIwMjYtMTEtMDVUMTQ6MjI6MDkuMDAwWiIsImlkIjoidHhfMDFIRjNLOVFaMi13MSJ9"
}

422Aralık 31 günden uzun

{
  "code": "DATE_RANGE_TOO_LONG",
  "message": "The date range is longer than allowed (at most 366 days for reports, 31 days for the transaction feed).",
  "request_id": "req_01HF3Q2R",
  "details": { "max_days": 31 }
}

Satır alanları

Alan	Tür	Açıklama
transaction_id	string	Cüzdan çağrısındaki işlem kimliği.
round_id	string	Tur kimliği.
type	string	bet, win, rollback. Jackpot ve promosyon kredisi win satırıdır.
amount	decimal(18,2)	İşlem tutarı. Free round bahsinde 0.
currency	ISO 4217	Oturum para birimi.
status	string	queued, pending, ok, rejected, ambiguous, reversed, void, manual_ok; tur ayrıntısındaki işlemlerle aynı.
round_closed	boolean	Çağrı turu kapatma sinyali taşıdı mı.
is_freeround	boolean	Free round işlemi.
campaign_id	string \| null	Free round kampanyası.
jackpot	object \| null	Jackpot kazancı: pool_id (eşleşen havuz yoksa null olabilir), level. Diğer işlemlerde null.
promo	object \| null	Promosyon kredisi (turnuva ödülü): type, id, rank (tam sayı). Diğer işlemlerde null.
ref_transaction_id	string \| null	Rollback’te geri alınan işlem.
operator_tx_id	string \| null	Yanıtınızdaki işlem kimliği.
player_id	string	Operatör tarafındaki oyuncu kimliği.
game_id	string	Oyun kodu.
site_id	string	Site kodu, örn. site_mrd01: sorgudaki site_id ile aynı değer.
created_at	date-time	İşlemin oluştuğu an; sıra ve aralık buna bakar.
completed_at	date-time \| null	Cüzdanınızdan sonucun alındığı an; bekleyen işlemde null.

Hata kodları

Kod	HTTP	Anlam
INVALID_SIGNATURE	401	İmza doğrulanamadı
TIMESTAMP_SKEW	401	X-Timestamp ±30 sn dışında
IP_NOT_ALLOWED	403	IP izin listesinde değil
SCOPE_MISSING	403	rounds.read kapsamı yok
SCOPE_DENIED	403	site_id sizin değil veya anahtarınızın kapsamı dışında
VALIDATION_ERROR	422	from veya to eksik ya da geçersiz sorgu parametresi
DATE_RANGE_INVALID	422	from, todan önce değil
DATE_RANGE_TOO_LONG	422	Aralık 31 günden uzun (details.max_days)
INVALID_CURSOR	422	cursor önceki yanıttan gelmiyor
RATE_LIMITED	429	Hız limiti aşıldı

← ÖncekiTur sorgulama & replay Sonraki →Free round kampanyaları