Obravnavajte omejitve zahtev in napake strežnika

Obravnavajte odgovor 429

Zahteva, ki doseže omejitev hitrosti, vrne 429 Too Many Requests, pri čemer je detail.status nastavljen na rate_limit_exceeded. Pred ponovnim poskusom preberite glave odgovora:

• Retry-After pove najmanjši čas čakanja v sekundah za zavrnjeno zahtevo.
• X-RateLimit-Limit pokaže omejitev skupine.
• X-RateLimit-Remaining pokaže število preostalih zahtev.
• X-RateLimit-Reset pokaže, kdaj se skupina ponastavi.

Počakajte toliko, kot določa Retry-After, nato poskusite znova z eksponentno naraščajočim zamikom in naključnim odstopanjem. Zmanjšajte število vzporednih zahtev in opravila postavite v vrsto, namesto da bi ob ponastavitvi okna naenkrat poslali veliko zahtev.

Obravnavajte napake strežnika

Pri odgovoru 500 javno telo vsebuje splošno napako in request_id; notranje podrobnosti izjeme niso vrnjene. Odgovor 503 lahko pomeni, da je zahtevana storitev začasno nedostopna.

Zahteve samo za branje ponovite z omejenim zamikom. Pred ponovitvijo zahteve za ustvarjanje, posodobitev, plačilo ali drugo spremembo stanja ugotovite, ali je prvi poskus uspel. Časovna omejitev ali odgovor 5xx ne dokazuje, da sprememba ni uspela, takojšnja ponovitev pa lahko podvoji delo.

Ohranite diagnostične podatke

Zabeležite čas, metodo, pot, stanje, telo odgovora in X-Request-Id. Nikoli ne beležite vrednosti x-api-key. Samodejne ponovitve ustavite po majhnem, vnaprej omejenem številu poskusov in napako posredujte v pregled.