API İstekleri ve Kotayı Anlamak

Abonelik planınız aylık bir istek hakkı içerir. Bu sayfa neyin istek olarak sayıldığını, hangi endpointlerin ücretsiz olduğunu ve limite ulaştığınızda neler olduğunu ayrıntılı olarak açıklar.

1 İstek Nedir?

1 istek = ücretli bir API endpointine yapılan 1 çağrı, yanıttan bağımsız olarak.

Ücretli bir endpointe yapılan her başarılı çağrı, kotanızdan tam olarak bir istek düşer. Yanıt boyutu, döndürülen öğe sayısı, sorgu parametreleri veya HTTP durumu sayımı etkilemez — 1.000 fixture döndüren bir çağrı ile 0 fixture döndüren bir çağrı tam olarak 1 istek tüketir.

İstekler abonelik başına sayılır; dolayısıyla API anahtarınızla yapılan tüm çağrılar aynı kotada birikir.

Hangi endpointler sayılır?

Ücretli endpointler (kotanıza sayılır)

Bu endpointlere yapılan her çağrı 1 istek kullanır:

/v4/players
/v4/settlements
/v4/fixtures
/v4/fixture
/v4/odds-by-tournaments
/v4/languages
/v4/sports
/v4/bookmakers
/v4/markets
/v4/tournaments
/v4/participants
/v4/scores
/v4/odds

Ücretsiz endpointler (kotanıza SAYILMAZ)

/v4/historical-odds — her zaman ücretsiz. Çağrılar istek sayacınızı asla artırmaz.

Ölçülmeyen endpointler (SAYILMAZ ve hiçbir zaman engellenmez)

/v4/account — her zaman erişilebilir, kota tükense bile. Bu sayede abonelik durumunuzu ve kalan kotayı istediğiniz zaman görüntüleyebilirsiniz.

Bir istek ne zaman sayılır?

Bir istek, yanıtın başarılı olup olmadığına bakılmaksızın endpoint işlemi tamamladıktan sonra sayılır. Bu şunları içerir:

200 OK — başarılı yanıtlar
4xx — istemci hataları (örn. geçersiz parametre, kaynak bulunamadı)
5xx — sunucu hataları

Not

Endpointe ulaşmadan önce reddedilen istekler — örneğin API anahtarınız geçersizse veya kotanız zaten tükendiyse — sayılmaz.

Limite Ulaşmak

Toplam istek sayınız planınızın request_limit değerine ulaştığında, ücretli veya ücretsiz bir endpointe (/v4/account hariç) yapılan sonraki her çağrı anında şu yanıtı döner:

HTTP/1.1 429 Too Many Requests

{
  "message": "Request limit exceeded",
  "details": "You have exceeded your request limit of X requests.",
  "code": "REQUEST_LIMIT_EXCEEDED"
}

Aboneliğinizi, mevcut kullanımı ve kotanızın sıfırlanacağı zamanı görmek için istediğiniz zaman /v4/account çağrısı yapmaya devam edebilirsiniz.

Kullanımınızı Kontrol Etme

İstediğiniz zaman GET /v4/account çağrısı yapın. Yanıt, aktif aboneliğiniz için şunları içerir:

request_limit — planınızın izin verdiği istek miktarı
request_count — mevcut dönemde tükettiğiniz ücretli istek sayısı

İstek tüketimini en aza indirme ipuçları

Yanıtları istemci tarafında önbelleğe alın, özellikle temel veriler nadiren değiştiğinde (örn. /v4/sports, /v4/bookmakers, /v4/markets, /v4/languages).
Mümkün olduğunda toplu istek yapın — birden fazla fixture gerektiğinde tek tek çağrılar yerine filtrelerle /v4/fixtures kullanın.
Sorumlu şekilde polling yapın — ücretli bir endpointe yapılan her poll 1 istektir; bu yüzden polling aralığını verinin gerçek değişim sıklığıyla eşleştirin.

Önceki sayfaOverview

Sonraki sayfaGET account