Kéréshatárok és szerverhibák kezelése
Olvassa el a korlátozási fejléceket, ismételjen óvatosan, és kulcs nélkül tárolja a diagnosztikai adatokat.
Frissítve:
Kezelje a 429-es választ
A korlátozott kérés 429 Too Many Requests választ kap, ahol a detail.status értéke rate_limit_exceeded. Újrapróbálkozás előtt nézze meg a fejléceket:
Retry-After: minimális várakozás másodpercben.X-RateLimit-Limit: a keret határa.X-RateLimit-Remaining: a hátralévő kérések száma.X-RateLimit-Reset: a keret visszaállításának ideje.
Várjon a Retry-After szerint, majd exponenciálisan növekvő, véletlenszerűen eltérített késleltetéssel ismételjen. Csökkentse a párhuzamos kéréseket, és sorba állítsa a munkát, ne küldjön egyszerre sok kérést az időablak visszaállásakor.
Kezelje a szerverhibákat
500 esetén a nyilvános válasz általános hibát és request_id-t tartalmaz, belső kivételrészleteket nem. A 503 egy szükséges szolgáltatás átmeneti elérhetetlenségét jelezheti.
A csak olvasási kéréseket korlátozott késleltetéssel ismételje. Létrehozás, frissítés, fizetés vagy más állapotváltoztató kérés ismétlése előtt állapítsa meg, befejeződött-e az első próbálkozás. Az időtúllépés vagy 5xx nem bizonyítja, hogy a módosítás meghiúsult; az azonnali ismétlés megduplázhatja a munkát.
Őrizze meg a diagnosztikát
Rögzítse az időbélyeget, metódust, útvonalat, állapotot, választörzset és X-Request-Id-t. A x-api-key értékét soha ne naplózza. Néhány korlátozott próbálkozás után állítsa le az automatikus ismétlést, és jelezze a hibát ellenőrzésre.