Riešiť obmedzenia počtu požiadaviek a chyby servera

Riešte odpoveď 429

Požiadavka, ktorá prekročila limit, vráti 429 Too Many Requests s hodnotou detail.status nastavenou na rate_limit_exceeded. Pred ďalším pokusom si prečítajte hlavičky odpovede:

• Retry-After udáva minimálny čas čakania v sekundách po odmietnutej požiadavke.
• X-RateLimit-Limit uvádza limit príslušnej skupiny.
• X-RateLimit-Remaining uvádza počet zostávajúcich požiadaviek.
• X-RateLimit-Reset uvádza, kedy sa skupina obnoví.

Počkajte čas uvedený v Retry-After a potom skúste požiadavku zopakovať s exponenciálne rastúcim odstupom a náhodnou odchýlkou. Obmedzte súbežné požiadavky a prácu zaraďte do frontu, namiesto toho, aby ste hneď po obnovení časového okna poslali veľkú dávku.

Riešte chyby servera

Pri odpovedi 500 verejné telo obsahuje všeobecnú chybu a request_id; interné podrobnosti výnimky sa nevracajú. Odpoveď 503 môže znamenať, že požadovaná služba je dočasne nedostupná.

Požiadavky určené iba na čítanie opakujte s obmedzeným odstupom. Pred opakovaním požiadavky, ktorá vytvára, mení, platí alebo inak upravuje stav, zistite, či sa prvý pokus dokončil. Vypršanie časového limitu ani odpoveď 5xx nedokazujú, že zmena zlyhala; okamžité opakovanie môže vytvoriť duplicitnú prácu.

Zachovajte diagnostické údaje

Zaznamenajte čas, metódu, cestu, stav, telo odpovede a X-Request-Id. Nikdy nezaznamenávajte hodnotu x-api-key. Automatické opakovanie po malom, vopred obmedzenom počte pokusov zastavte a chybu predložte na kontrolu.