İçeriğe Geç

Bahis IBAN Beslemesi

GET /api/v1/betting-ibans/feed

Listedeki her değişikliği sıra numarasıyla döner: yeni kayıt, kaydın güncellenmesi, etkinden pasife geçiş ve listeden çıkış. Kendi kopyanızı güncel tutmak için kullanın.

Parametreler

  • after — elinizdeki son sıra numarası. Baştan okumak için 0 (varsayılan).
  • limit — sayfadaki öğe sayısı; 1–1000, varsayılan 100.

Yanıt

{
  "headSequence": 1843,
  "items": [
    {
      "sequence": 1840,
      "recordId": "3f6c1c0e-5d2a-4a0b-9c1e-7b2f4d6a8e10",
      "revision": 3,
      "withdrawn": true,
      "validFrom": "2026-11-09T19:41:07Z"
    },
    {
      "recordId": "3f6c1c0e-5d2a-4a0b-9c1e-7b2f4d6a8e10",
      "iban": "TR039999901234567890123456",
      "bankCode": "99999",
      "bankName": null,
      "recipientNameMasked": null,
      "status": "removed",
      "listed": false,
      "firstDetectedAt": "2026-11-02T08:14:00Z",
      "lastSeenAt": "2026-11-09T19:40:00Z",
      "observationCount": 0,
      "sourceCount": 0,
      "sourceKinds": [],
      "brands": [],
      "evidence": [],
      "removalReason": "objectionAccepted",
      "revision": 4,
      "sequence": 1843,
      "contentHash": "0be7c2d94f5a61e8b3a7d0c5f29e4b168a3d7c0f5e2b9a41d6c8f03e7b5a2d19",
      "schemaVersion": 1,
      "withdrawn": false,
      "validFrom": "2026-11-10T11:05:12Z"
    }
  ]
}
  • headSequence — beslemenin en yeni sıra numarası. Son öğenizin sequence değerine eşitse günceldesiniz.
  • items[] — after değerinden sonraki öğeler, sıra numarasına göre. Her öğe bir kaydın bir hâlidir; alanları Bahis IBAN Listesi sayfasındaki kayıt alanlarıdır, ek olarak:
    • validFrom — bu hâlin geçerli olmaya başladığı an (UTC).
    • withdrawn — öğe geri çekilmiş mi. false ise öğe yukarıdaki gibi bir kayıt hâlidir.

Geri çekilmiş öğeler

withdrawn true olan öğe bir kayıt hâli değildir: yalnız sequence, recordId, revision, validFrom ve withdrawn alanlarını taşır; IBAN, ad, içerik ve contentHash yoktur. Bir kayıt listeden çıkarıldığında (removed), o kaydın çıkarmadan önce yayımlanmış bütün hâlleri beslemede geri çekilmiş öğe olarak görünür. Sıra numaraları yerinde kalır, besleme boşluksuz kalır.

  • Geri çekilmiş öğeyi yok sayın: kopyanıza kayıt eklemeyin, kayıt güncellemeyin. Yalnız sıra numaranızı ilerletin.
  • O hâli daha önce sakladıysanız silin. Geri çekilen hâl, düzeltme ya da kabul edilen bir itirazla listeden çıkarılmış bir kayda aittir; arşivinizde, günlüğünüzde ya da önbelleğinizde kalmamalıdır. recordId hangi kaydın hâli olduğunu söyler.
  • Kaydı kopyanızdan çıkaran öğe geri çekilmiş öğe değil, ardından gelen removed öğesidir (listed false).

Kayıt daha sonra yeni bir kararla yeniden listelenirse, çıkarmadan önceki hâlleri geri çekilmiş kalır; yeni listeleme olağan bir öğe olarak gelir.

Çıkış bildirimi yalnız kaydı bulmanıza yeteni taşır: recordId, iban, bankCode, status, removalReason ve zamanlar. Ad, marka, kaynak ya da kanıt taşımaz: recipientNameMasked ve bankName null, brands, sourceKinds ve evidence boş, sayılar 0'dır.

Nasıl uygulanır

  1. Son işlediğiniz sequence değerini saklayın ve after olarak gönderin.
  2. Gelen her öğeyi sırayla uygulayın: withdrawn true ise öğeyi yok sayın (yukarıya bakın); değilse listed true ise kaydı ekleyin ya da güncelleyin, false ise kaydı kopyanızdan çıkarın.
  3. items boş dönene kadar devam edin.

Sıra numaraları boşluksuzdur ve yayım sırasındadır: N numaralı öğeyi gördüyseniz N ve altındaki hiçbir öğeyi kaçırmış olamazsınız. Besleme hiç budanmaz; her zaman 0'dan baştan okunabilir. Baştan okuyan bir tüketici, listeden çıkarılmış kayıtların eski hâllerini içerik olarak almaz; yerlerinde geri çekilmiş öğeleri görür.

Çıkarılan kaydı çıkarın. removed bir düzeltme ya da kabul edilen bir itirazdır; kaydı kopyanızda tutmaya devam etmek hatalı bir tespiti sürdürmek olur. Çıkış bildiriminde recipientNameFull hiçbir anahtara gönderilmez. recipientNameFull beslemede yalnız listedeki bir kaydın güncel hâlinde yer alır; aynı kaydın eski hâllerinde yoktur.

Kopyanızın doğru olduğunu Bahis IBAN Liste Durumu yanıtındaki özetle sınayabilirsiniz.

Hata yanıtları

  • 400 VALIDATION_ERROR — after negatif ya da limit aralık dışında.
  • 503 BETTING_IBAN_UNAVAILABLE — hizmet geçici olarak kapalı; Retry-After kadar bekleyin.

Yetki

Api.BettingIban.Read iznini gerektirir. Alıcı adının maskesiz hâli için ek olarak Api.BettingIban.FullName gerekir.

Parametreler

İsimKonumTipZorunluAçıklama
after Query integer Hayır Elinizdeki son sıra numarası; baştan okumak için 0 (varsayılan).
limit Query integer Hayır Sayfadaki öğe sayısı; 1–1000, varsayılan 100.

Yanıtlar

200 — headSequence (beslemenin en yeni sıra numarası) ve items[]: sıra numarasına göre kayıt hâlleri; her biri liste kaydının alanlarını, validFrom ve withdrawn alanlarını taşır. listed false olan öğe kaydın listeden çıktığını bildirir. withdrawn true olan öğe geri çekilmiştir: yalnız sequence, recordId, revision ve validFrom taşır, yok sayılır ve daha önce saklanmış kopyası silinir.

400 — after negatif ya da limit aralık dışında (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.