İçeriğe Geç

Bahis IBAN Listesi

GET /api/v1/betting-ibans

Listede yer alan kayıtları (etkin ve pasif) IBAN sırasıyla, sayfa sayfa döner. Listeyi ilk kez almak ya da kendi kopyanızı baştan kurmak için kullanın; sonrasındaki değişiklikleri Bahis IBAN Beslemesi verir.

Bu liste ne söyler, ne söylemez

Bahis IBAN Listesi bir tespit listesidir: bir IBAN'ın yasa dışı bahis ödemesi toplamak için kullanıldığının gözlemlendiğini ve bu tespitin doğrulandığını söyler. Bir risk puanı değildir ve hesap sahibi hakkında bir suçlama değildir: hesap, sahibinin bilgisi dışında kullanılıyor olabilir. Ne yapılacağına kendi kurallarınız ve mevzuat karar verir.

Parametreler

  • after — önceki sayfanın nextAfter değeri. İlk sayfada göndermeyin.
  • limit — sayfadaki kayıt sayısı; 1–1000, varsayılan 100.
  • status — active ya da passive. Gönderilmezse ikisi de döner.

Yanıt

{
  "listSequence": 1842,
  "items": [
    {
      "recordId": "3f6c1c0e-...",
      "iban": "TR039999901234567890123456",
      "bankCode": "99999",
      "bankName": "Örnek Banka A.Ş.",
      "recipientNameMasked": "ÖR*** Kİ***",
      "status": "active",
      "listed": true,
      "firstDetectedAt": "2026-11-02T08:14:00Z",
      "lastSeenAt": "2026-11-09T19:40:00Z",
      "observationCount": 4,
      "sourceCount": 2,
      "sourceKinds": [ "website" ],
      "brands": [ "Örnek Marka" ],
      "evidence": [
        { "evidenceId": "9a1b...", "sha256": "5f2a...", "observedAt": "2026-11-09T19:40:00Z" }
      ],
      "removalReason": null,
      "revision": 3,
      "sequence": 1842,
      "contentHash": "c41d...",
      "schemaVersion": 1
    }
  ],
  "nextAfter": "TR039999901234567890123456"
}
  • listSequence — sayfanın okunduğu andaki besleme sıra numarası.
  • items[] — kayıtlar, IBAN'a göre artan sırada.
  • nextAfter — sonraki sayfa için after değeri. null ise son sayfadasınız.

Kayıt alanları:

  • recordId — kaydın kalıcı kimliği.
  • iban — 26 karakter, büyük harf, ayırıcısız.
  • bankCode, bankName — IBAN'daki banka kodu ve o kodun adı. Kod katılımcı tablosunda yoksa bankName null'dır; bu kaydı geçersiz kılmaz.
  • recipientNameMasked — kaynağın IBAN'ın yanında gösterdiği alıcı adı, maskelenmiş hâliyle. Kaynak ad göstermediyse null. Bu ad kaynağın beyanıdır; hesabın gerçek sahibinin adı olduğu doğrulanmamıştır.
  • recipientNameFull — aynı adın maskesiz hâli. Yalnız Api.BettingIban.FullName izni olan anahtara ve yalnız kayıt listedeyken, kaydın güncel hâliyle gönderilir; izin yoksa alan yanıtta hiç yer almaz. Maskeleme sunucuda yapılır.
  • status — active (son gözlem en çok 30 gün önce) ya da passive (31–180 gün). Bu ikisi listededir. Beslemede ayrıca archived (180 günden uzun süredir gözlem yok) ve removed (düzeltme ya da itiraz sonucu çıkarıldı) görülür; ikisi de listede değildir.
  • listed — bu hâliyle kayıt listede mi. Akışınızı bu alana bağlayın.
  • firstDetectedAt, lastSeenAt — ilk tespit ve son gözlem (UTC).
  • observationCount, sourceCount — gözlem ve kaynak sayısı. Bunlar sayımdır; puan ya da risk derecesi değildir.
  • sourceKinds[] — gözlemlerin yapıldığı kaynakların genel türü. Kodlar: messaging_channel, website, social_account, forum, manual. Yeni kodlar eklenebilir; tanımadığınız kodu yok sayın.
  • brands[] — IBAN'ın ilişkilendirildiği yasa dışı bahis markaları ya da ödeme aracıları.
  • evidence[] — kaydın dayandığı kanıtların kimliği, SHA-256 özeti ve gözlem zamanı. Kanıtın kendisi bu API'den verilmez.
  • removalReason — çıkarılan kayıtta objectionAccepted, verificationError ya da other; aksi hâlde null.
  • revision, sequence — kaydın kaçıncı hâli olduğu ve bu hâli yayımlayan besleme sıra numarası.
  • contentHash — kaydın içeriğinin SHA-256 özeti (küçük harf onaltılık). İçerik değişince değişir; recipientNameFull bu özete dâhil değildir.
  • schemaVersion — kayıt içeriğinin şema sürümü.

Sayfalama

Sıra IBAN'a göredir ve kalıcıdır: nextAfter değerini after olarak gönderdiğinizde hiçbir kayıt atlanmaz ya da iki kez gelmez. Sayfalar arasında liste değişebilir (listSequence ilerler); tam tutarlı bir kopya için listeyi aldıktan sonra beslemeyi, ilk sayfada gördüğünüz listSequence değerinden itibaren okuyun.

Hata yanıtları

  • 400 VALIDATION_ERROR — limit aralık dışında, after bir önceki sayfanın değeri değil ya da status tanınmıyor.
  • 503 BETTING_IBAN_UNAVAILABLE — hizmet geçici olarak kapalı. Liste verilmedi; bu yanıt listenin boş olduğu anlamına gelmez. Retry-After kadar bekleyin.

Yetki

Api.BettingIban.Read iznini gerektirir. Bu izin katmanlara kendiliğinden verilmez; anahtarınıza ayrıca tanımlanır. Alıcı adının maskesiz hâli için ek olarak Api.BettingIban.FullName gerekir.

Parametreler

İsimKonumTipZorunluAçıklama
after Query string Hayır Önceki sayfanın nextAfter değeri. İlk sayfada gönderilmez.
limit Query integer Hayır Sayfadaki kayıt sayısı; 1–1000, varsayılan 100.
status Query string Hayır active ya da passive. Gönderilmezse ikisi de döner.

Yanıtlar

200 — listSequence (sayfanın okunduğu liste durumu), items[] (IBAN sırasıyla kayıtlar: recordId, iban, bankCode, bankName, recipientNameMasked, status, listed, firstDetectedAt, lastSeenAt, observationCount, sourceCount, sourceKinds[], brands[], evidence[], removalReason, revision, sequence, contentHash, schemaVersion) ve nextAfter (son sayfada null).

400 — limit aralık dışında, after önceki sayfanın değeri değil ya da status tanınmıyor (VALIDATION_ERROR).

503 — Hizmet geçici olarak kapalı (BETTING_IBAN_UNAVAILABLE). Bu yanıt 'listede yok' anlamına gelmez. Retry-After kadar bekleyip yeniden deneyin.