Telm API'yi iki şekilde ölçer: bir dakika başına oran limiti (bir patlama tavanı) ve bir günlük kota (UTC günü için toplam bütçeniz). İkisi de planla ölçeklenir. Ölçülen her yanıt X-Quota-Limit, X-Quota-Used ve X-Quota-Reset döndürür, böylece kalan bütçenizi her zaman bilirsiniz; her iki limit de aşıldığında bir Retry-After başlığıyla 429 döndürür.
1İki limit: dakika başına oran ve günlük kota
İki ayrı tavan vardır. Dakika başına oran limiti, herhangi bir tek dakika içinde kaç istek yapabileceğinizi sınırlar ve patlamaları yumuşatır. Günlük kota ise genel bütçenizdir: tüm UTC günü boyunca kaç ölçülen çağrı yapabileceğinizi sınırlar.
Bunlar bağımsızdır. Hâlâ bol miktarda günlük kotanız varken dakika başına limite ulaşabilirsiniz (yalnızca çok hızlı gönderiyorsunuz) ya da dakika başına limitin çok altındayken günlük kotanızı tüketebilirsiniz (günü kullanıp bitirdiniz). İkisi de bir 429 durumu döndürür, ama farklı nedenlerle — bunları ayırt etmek için gövdedeki hata kodunu kontrol edin.
- Dakika başına oran limiti — bir patlama tavanı, her dakika sıfırlanır.
- Günlük kota — o gün için toplam ölçülen çağrılarınız, UTC gece yarısında sıfırlanır.
- Kota hesap başına bir kez sayılır, tüm anahtarlarınız arasında paylaşılır.
2Plana göre günlük kota
Günlük kotanız, UTC günü başına yapabileceğiniz ölçülen API çağrılarının sayısıdır ve planınıza bağlıdır. Sayaç tüm anahtarlarınız arasında paylaşılır ve yönettiğiniz gruplar arasındaki en iyi planı izler — ücretli bir aboneliğiniz yoksa Free katmanındasınız.
Pencere UTC takvim günüdür, dolayısıyla kullanılan sayacınız UTC gece yarısında sıfıra sıfırlanır. Bir toplu spam kontrolü, tüm istek için tek bir çağrı değil, gruptaki her öğe için bir çağrıya mal olur.
- Free — günde 100 çağrı.
- Basic — günde 1.000 çağrı.
- Pro — günde 10.000 çağrı.
- Business — günde 50.000 çağrı.
3Plana göre dakika başına oran limiti
Günlük kotanın üstüne, her API anahtarı, plan katmanına göre dakika başına belirli bir istek sayısıyla sınırlıdır. Bu bir yumuşatma limitidir: günlük bütçe henüz tükenmekten çok uzakken bile, tek bir istemcinin bir saniyede büyük bir ani artış göndermesini durdurur.
Ayrıca, platformu kararlı tutmak için tüm API genelinde geniş IP başına ve hesap başına tavanlar uygulanır. Normal kullanımda — istikrarlı, temposu ayarlanmış istekler — bunlara asla dokunmazsınız; yalnızca kötüye kullanan patlamalarda tetiklenirler.
- Free ve Basic — dakikada 60 istek.
- Pro — dakikada 600 istek.
- Business — dakikada 1.800 istek.
- İstekleri hepsini birden ateşlemek yerine yayın.
4Kalan bütçenizi okumak
Ne kadar kota kaldığını asla tahmin etmek zorunda değilsiniz. Ölçülen her yanıt — başarı veya başarısızlık — üç başlık içerir: X-Quota-Limit (günlük limitiniz), X-Quota-Used (bugün ne kadar çağrı harcadığınız) ve X-Quota-Reset (UTC olarak sayacın sıfırlandığı an).
Spam kontrol uç noktaları aynı sayıları yanıt gövdesinde bir quota nesnesi altında da yansıtır, böylece başlıkları ayrıştırmadan kalan bütçenizi okuyabilirsiniz. Bunları kendi isteklerinizin temposunu ayarlamak ve tükenmeden önce kendinizi uyarmak için kullanın.
- X-Quota-Limit — günlük çağrı limitiniz.
- X-Quota-Used — bugüne kadar harcanan çağrılar.
- X-Quota-Reset — UTC olarak sıfırlama zamanı (RFC 3339).
- Spam kontrol yanıtları aynı alanlara sahip bir quota nesnesi de içerir.
5429'da ne olur
İki limitten birini aştığınızda, API kaç saniye bekleyeceğinizi söyleyen bir Retry-After başlığıyla HTTP 429 döndürür. Dakika başına oran limiti için Retry-After yaklaşık bir dakikadır. Günlük kota için gövde bir daily_quota_exceeded kodu artı planınızı, limiti, kullanılan sayıyı, sıfırlama zamanını ve bir yükseltme ipucunu taşır ve Retry-After, UTC gece yarısına doğru geri sayar.
429'u ele almanın doğru yolu, uç noktayı dövmek değil, Retry-After gecikmesinden sonra geri çekilip yeniden denemektir. İyi davranan istemciler başlığı okur ve duraklar; hemen yeniden denemeye devam eden istemciler ise yalnızca engelli kalır.
- 429 rate_limit_exceeded — çok hızlı gönderdiniz; yaklaşık bir dakika bekleyin.
- 429 daily_quota_exceeded — gün tükendi; UTC sıfırlamasına kadar bekleyin veya yükseltin.
- Yeniden denemeden önce her zaman Retry-After başlığına uyun.