Bu nədir
Sürət limitləri üçün pulsuz başlıq oxuyucusu. Retry After, X RateLimit ailəsi, IETF RateLimit sahələri və GitHub, OpenAI, Anthropic, Shopify və Discord formatlarını başa düşür.
429 sadə sözlərlə
API'niz 429 qaytardı. Əslində nə demək istədiyi buradadır.
Cavab başlıqlarını yapışdırın. Rate Limit Story limiti, qalan payı, nə vaxt sıfırlanacağını və nə qədər gözləmək lazım olduğunu oxuyur, sonra dörd kadrlıq hekayə və divara dirənən müştəriniz üçün hazır cavab yazır.
- Müştəri
600 paketdən 501'incisi gedir…
- API
Həddindən çox sorğu! Token qabı boşdur.
- Rate Limit Story
20 san gözlə, sonra bir az təsadüfi gecikmə ilə yenidən cəhd et.
Kimin üçündür
API sahibləri, tərtibatçı dəstəyi, tərəfdaş menecerləri və müştərisindən heç bir izahı olmayan 429 ekran görüntüsü alan hər kəs üçün.
Hansı problemi həll edir
Limit başlıqları anlaşılmazdır, Unix vaxtını saniyələrlə qarışdırır və hər provayderdə fərqlidir. İnsanlar təxmin edir, çox tez yenidən cəhd edir və daha uzun müddət bloklanır.
Bir cavabın hekayəsini danışın
Hər şey bu tabda oxunur. Yapışdırdığınız heç nə yüklənmir və saxlanmır.
Nümunə yüklə
Xam başlıqları, curl -i çıxışını və ya başlıqlardan ibarət JSON obyektini yapışdırın. Status sətri məcburi deyil.Hələ hekayə yoxdur
Uğursuz sorğunun başlıqlarını yapışdırın və ya nümunələrdən birini yükləyin.
Başlıqlar heç vaxt bu səhifədən çıxmır. Yenə də ekran görüntüsü paylaşmazdan əvvəl avtorizasiya və cookie başlıqlarını silin.
Başa düşdüyü başlıqlar
Fərqli üslublu başlıqları bir dəfəyə yapışdıra bilərsiniz. Adlarda böyük kiçik hərf fərq etmir.
Retry After
Retry-After: 20Saniyə və ya HTTP tarixi. Varsa, digər bütün sıfırlanma işarələrindən üstündür.
X RateLimit ailəsi
X-RateLimit-Limit: 5000
X-RateLimit-Remaining: 0
X-RateLimit-Reset: 1792661820GitHub, Twitter üslublu API'lər və bir çox başqaları istifadə edir. Sıfırlanma dəyəri Unix saniyəsi, millisaniyəsi və ya indidən saniyə ola bilər, alət hansını seçdiyini deyir.
IETF RateLimit
RateLimit-Policy: "default";q=100;w=60
RateLimit: "default";r=7;t=42Kvota, pəncərə, qalan pay və sıfırlanmaya qalan vaxtı daşıyan standart sahələr.
OpenAI və Anthropic
x-ratelimit-remaining-tokens: 0
x-ratelimit-reset-tokens: 18.4s6m0s kimi müddətlərlə ayrı sorğu və token qabları. Boşalan qab sizi saxlayan qab kimi işarələnir.
Shopify və Discord
X-Shopify-Shop-Api-Call-Limit: 38/40
X-RateLimit-Reset-After: 2.75İstifadə olunan və ümumi sayğaclar, saniyə ilə sıfırlanma, qablar, əhatə dairələri və ümumi limitlər.
Necə istifadə edilir
Başlıqları kopyalayın
Brauzerin şəbəkə tabından, curl -i çıxışından, loglarınızdan və ya müştərinin göndərdiyi ekran görüntüsündən. Yalnız başlıq sətirləri önəmlidir.
Yapışdırıb hekayəni danışın
Hər qab ayrıca oxunur, boşalan və ya boşalmağa ən yaxın olan qab hekayənin baş qəhrəmanı olur.
Dörd kadrı oxuyun
Nə baş verdi, vəziyyətiniz, nə vaxt sıfırlanır və nə etməli. Vaxtlar həm UTC ilə, həm də öz saat qurşağınızla göstərilir.
Cavabı göndərin
Hazır cavabı müraciətə kopyalayın və ya öz qeydləriniz üçün bütün hekayəni götürün.
Bilmək faydalıdır
- Alət yalnız yapışdırdığınız başlıqları izah edir. API'yə müraciət etmir və API'nin özündə saxladığı limitləri görmür.
- Sıfırlanma dəyəri birmənalı olmayanda bir milyarddan böyük ədədlər Unix vaxtı, kiçikləri isə saniyə sayılır.
- Təhlükəsiz temp üçün həm limit, həm də pəncərə müddəti lazımdır. Bir çox API yalnız limiti göndərir.
- Öz saat qurşağınızdakı vaxtlar bu cihazın saatına əsaslanır.
Suallar
GitHub niyə 429 əvəzinə 403 göndərir?
GitHub limitə düşən bəzi sorğulara 403 ilə cavab verir. Qalan pay sıfırdırsa, hekayə bunu yenə limitli sayır.
Hansı əsasdır, Retry After yoxsa sıfırlanma vaxtı?
Retry After. Bu, serverin sizə dəqiq nə qədər gözləməli olduğunuzu deməsidir, sıfırlanma vaxtı isə bütün pəncərəni təsvir edir.
Təsadüfi gecikmə nədir və niyə əlavə edilir?
Kiçik, təsadüfi əlavə gözləmə. Bu olmasa, bloklanan bütün müştərilər eyni saniyədə təkrar cəhd edir və yenə limitə ilişir.
Real başlıqları yapışdırmaq təhlükəsizdir?
Səhifə heç yerə heç nə göndərmir. Yenə də nəsə paylaşmazdan əvvəl Authorization və cookie başlıqlarını silin.