Nedir
Hız limitleri için ücretsiz bir başlık okuyucu. Retry After, X RateLimit ailesi, IETF RateLimit alanları ve GitHub, OpenAI, Anthropic, Shopify ile Discord biçimlerini anlar.
429 hatası sade bir dille
API'niz 429 dedi. Aslında ne demek istediği burada.
Yanıt başlıklarını yapıştırın. Rate Limit Story limiti, kalan hakkı, ne zaman sıfırlanacağını ve ne kadar beklemeniz gerektiğini okur, ardından dört karelik bir hikâye ve duvara çarpan müşteriniz için hazır bir yanıt yazar.
- İstemci
600 isteğin 501'incisi gidiyor…
- API
Çok fazla istek! Token kovası boş.
- Rate Limit Story
20 sn bekle, sonra biraz rastgele gecikmeyle tekrar dene.
Kimin için
API sahipleri, geliştirici destek ekipleri, iş ortağı yöneticileri ve müşterisinden bağlamsız bir 429 ekran görüntüsü alan herkes için.
Hangi sorunu çözer
Hız limiti başlıkları anlaşılması zor, Unix zamanıyla saniyeyi karıştırır ve sağlayıcıdan sağlayıcıya değişir. İnsanlar tahmin yürütür, çok erken tekrar dener ve daha uzun süre engellenir.
Bir yanıtın hikâyesini anlatın
Her şey bu sekmede okunur. Yapıştırdığınız hiçbir şey yüklenmez ya da saklanmaz.
Örnek yükle
Ham başlıkları, curl -i çıktısını ya da başlıklardan oluşan bir JSON nesnesini yapıştırın. Durum satırı isteğe bağlıdır.Henüz hikâye yok
Başarısız bir çağrının başlıklarını yapıştırın ya da örneklerden birini yükleyin.
Başlıklar bu sayfadan hiç çıkmaz. Yine de ekran görüntüsü paylaşmadan önce yetki ve çerez başlıklarını silin.
Anladığı başlıklar
Farklı tarzlardaki başlıkları tek seferde yapıştırabilirsiniz. Büyük küçük harf fark etmez.
Retry After
Retry-After: 20Saniye ya da HTTP tarihi. Varsa diğer tüm sıfırlanma ipuçlarının önüne geçer.
X RateLimit ailesi
X-RateLimit-Limit: 5000
X-RateLimit-Remaining: 0
X-RateLimit-Reset: 1792661820GitHub, Twitter tarzı API'ler ve daha birçoğu kullanır. Sıfırlanma değeri Unix saniyesi, milisaniyesi ya da şu andan itibaren saniye olabilir. Araç hangisini seçtiğini söyler.
IETF RateLimit
RateLimit-Policy: "default";q=100;w=60
RateLimit: "default";r=7;t=42Kota, pencere, kalan hak ve sıfırlanma süresini taşıyan standart alanlar.
OpenAI ve Anthropic
x-ratelimit-remaining-tokens: 0
x-ratelimit-reset-tokens: 18.4s6m0s gibi sürelerle ayrı istek ve token kovaları. Boşalan kova sizi durduran kova olarak işaretlenir.
Shopify ve Discord
X-Shopify-Shop-Api-Call-Limit: 38/40
X-RateLimit-Reset-After: 2.75Kullanılan ve toplam sayaçları, saniye cinsinden sıfırlanma, kovalar, kapsamlar ve genel limitler.
Nasıl kullanılır
Başlıkları kopyalayın
Tarayıcının ağ sekmesinden, curl -i çıktısından, kayıtlarınızdan ya da müşterinin gönderdiği ekran görüntüsünden. Yalnızca başlık satırları önemli.
Yapıştırıp hikâyeyi anlatın
Her kova ayrı okunur. Boşalan ya da boşalmaya en yakın olan kova hikâyenin baş kahramanı olur.
Dört kareyi okuyun
Ne oldu, durumunuz, ne zaman sıfırlanır ve ne yapmalı. Saatler hem UTC hem de kendi saat diliminizde.
Yanıtı gönderin
Hazır yanıtı destek kaydına kopyalayın ya da kendi notlarınız için tüm hikâyeyi alın.
Bilmekte fayda var
- Yalnızca yapıştırdığınız başlıkları açıklar. API'yi çağırmaz, API'nin kendine sakladığı limitleri göremez.
- Sıfırlanma değeri belirsizse bir milyarın üstündeki sayılar Unix zamanı, daha küçükleri saniye sayılır.
- Güvenli hız için hem limit hem de pencere süresi gerekir. Birçok API yalnızca limiti gönderir.
- Kendi saat diliminizdeki saatler bu cihazın saatine göre gösterilir.
Sorular
GitHub neden 429 yerine 403 gönderiyor?
GitHub limitli bazı çağrılara 403 ile yanıt verir. Kalan hak sıfırsa hikâye bunu yine limitli sayar.
Hangisi geçerli, Retry After mı sıfırlanma zamanı mı?
Retry After. Sunucu size tam olarak ne kadar beklemeniz gerektiğini söyler, sıfırlanma zamanı ise tüm pencereyi anlatır.
Rastgele gecikme nedir ve neden eklenir?
Küçük, rastgele bir ek bekleme. Bu olmazsa engellenen tüm istemciler aynı saniyede tekrar dener ve limite yeniden takılır.
Gerçek başlıkları yapıştırmak güvenli mi?
Sayfa hiçbir yere bir şey göndermez. Yine de bir şey paylaşmadan önce Authorization ve çerez başlıklarını silin.