Pangasiwaan ang rate limit at server error
Maghintay pagkatapos ng 429 response at maingat na ulitin ang ligtas na operasyon matapos ang pansamantalang server error.
Na-update noong
Pangasiwaan ang 429 response
Ang rate-limited request ay nagbabalik ng 429 Too Many Requests na may detail.status na rate_limit_exceeded. Basahin ang response headers bago ulitin:
Retry-After: pinakamababang paghihintay sa segundo para sa tinanggihang request.X-RateLimit-Limit: limitasyon ng bucket.X-RateLimit-Remaining: natitirang bilang ng request.X-RateLimit-Reset: oras ng pag-reset ng bucket.
Hintayin ang Retry-After, saka ulitin nang may exponential backoff at jitter. Bawasan ang parallel requests at ilagay sa queue ang trabaho sa halip na biglang magpadala pag-reset ng window.
Pangasiwaan ang server error
Para sa 500, pangkalahatang error at request_id lang ang nasa pampublikong body; walang internal exception details. Maaaring ibig sabihin ng 503 na pansamantalang hindi available ang kailangang serbisyo.
Ulitin ang read-only requests nang may limitadong backoff. Bago ulitin ang create, update, payment, o ibang state-changing request, alamin kung natapos ang unang pagtatangka. Hindi patunay ng pagkabigo ang timeout o 5xx; maaaring madoble ang trabaho kung uulitin agad.
Itabi ang diagnostic details
Itala ang timestamp, method, path, status, response body, at X-Request-Id. Huwag kailanman i-log ang x-api-key. Ihinto ang automatic retries matapos ang maliit na takdang bilang at ipasuri ang pagkabigo.