Ana içeriğe geç

API Kullanım Skorları

Kimlik doğrulamalı bir endpoint'e yapılan her çağrı, endpoint'in skorunu client'ınızın içinde bulunulan takvim ayındaki kullanımına ekler. Client'ın bir monthly_limit değeri varsa ve ayın toplamı bu değere ulaşırsa, sonraki çağrılar bir sonraki ay başlayana kadar HTTP 429 ile reddedilir.

Bir çağrının maliyeti​

Kimlik doğrulamalı her endpoint şu anda 1000 skor tutar. Sağlık kontrolleri (GET /health, /v1/health, /v2/health) ve token endpoint'i skorlanmaz.

Sabit oranı bir sözleşme değil, bugünkü fiyatlandırma olarak kabul edin: platform ileride endpoint'leri ayrı ayrı fiyatlandırabilir. Bütçenizi her zaman güncel değerleri bildiren X-Monthlylimit-* başlıklarıyla yönetin.

Kullanım nasıl birikir​

  • Kullanım kullanıcı ya da düğüm başına değil, client başına sayılır.
  • Bir çağrı; kimlik doğrulama, sertifika ve IP kontrolleri ile hız sınırından geçtikten sonra, sonucu ne olursa olsun sayılır: endpoint'in daha sonra reddettiği bir çağrı (doğrulama hatası, bulunamadı, …) da skorunu tüketir.
  • Toplam her takvim ayının başında sıfırlanır.

Kalan bütçenizi okumak​

Client'ınızın aylık sınırı varsa, kimlik doğrulamalı her yanıt şu başlıkları taşır:

BaşlıkAnlamı
X-Monthlylimit-LimitClient'ın aylık hakkı
X-Monthlylimit-UsedBu ay şimdiye kadarki kullanım
X-Monthlylimit-RemainingÇağrılar reddedilmeye başlamadan önce kalan

Sınıra ulaşıldığında​

HTTP/1.1 429 Too Many Requests
Retry-After: 3600
X-Monthlylimit-Limit: 1000000
X-Monthlylimit-Used: 1000000
X-Monthlylimit-Remaining: 0
{
  "code": 10012,
  "domain": 100,
  "message": "monthly usage limit exceeded"
}

X-Monthlylimit-Remaining sıfıra ulaşmadan platform operatöründen daha yüksek bir monthly_limit isteyin. Bkz. Client Oluşturma ve Hatalar.