Řešte limity požadavků a chyby serveru

Zpracujte odpověď 429

Požadavek omezený limitem vrací 429 Too Many Requests a nastaví detail.status na rate_limit_exceeded. Před opakováním požadavku si přečtěte hlavičky odpovědi:

• Retry-After udává minimální dobu čekání v sekundách před opakováním odmítnutého požadavku.
• X-RateLimit-Limit uvádí limit pro skupinu požadavků.
• X-RateLimit-Remaining uvádí počet zbývajících požadavků.
• X-RateLimit-Reset uvádí, kdy se limit skupiny obnoví.

Počkejte po dobu uvedenou v Retry-After, pak požadavek opakujte s exponenciálně prodlužovanou prodlevou a náhodnou odchylkou. Omezte počet souběžných požadavků a práci zařazujte do fronty místo toho, abyste po obnovení časového okna odeslali velkou dávku.

Zpracujte chyby serveru

U odpovědi 500 obsahuje veřejné tělo obecnou chybu a request_id; interní podrobnosti výjimky se nevracejí. Odpověď 503 může znamenat, že potřebná služba je dočasně nedostupná.

Požadavky pouze pro čtení opakujte s omezenou prodlevou. Než zopakujete požadavek na vytvoření, aktualizaci, platbu nebo jinou změnu stavu, zjistěte, zda se první pokus dokončil. Vypršení časového limitu ani odpověď 5xx nedokazují, že změna selhala; okamžité opakování může práci zdvojit.

Uchovejte diagnostické údaje

Zaznamenejte čas, metodu, cestu, stav, tělo odpovědi a X-Request-Id. Nikdy nezaznamenávejte hodnotu x-api-key. Automatické opakování zastavte po malém, předem omezeném počtu pokusů a zobrazte chybu ke kontrole.