Gestionați limitele de cereri și erorile serverului

Gestionați un răspuns 429

O cerere limitată ca frecvență returnează 429 Too Many Requests, cu detail.status setat la rate_limit_exceeded. Citiți antetele răspunsului înainte de a încerca din nou:

• Retry-After indică timpul minim de așteptare, în secunde, pentru o cerere respinsă.
• X-RateLimit-Limit arată limita categoriei.
• X-RateLimit-Remaining arată câte cereri mai sunt disponibile.
• X-RateLimit-Reset arată când se resetează categoria.

Așteptați intervalul Retry-After, apoi reîncercați cu o întârziere exponențială și variație aleatorie. Reduceți cererile paralele și puneți lucrările în coadă, în loc să trimiteți un val imediat ce fereastra se resetează.

Gestionați erorile serverului

Pentru un răspuns 500, corpul public conține o eroare generică și un request_id; detaliile interne ale excepției nu sunt returnate. Un răspuns 503 poate indica faptul că un serviciu necesar este indisponibil temporar.

Reluați cererile doar pentru citire cu o întârziere limitată. Înainte de a relua o cerere de creare, actualizare, plată sau altă schimbare de stare, stabiliți dacă prima încercare s-a încheiat. Un timeout sau un răspuns 5xx nu dovedește că modificarea a eșuat, iar repetarea imediată poate dubla operațiunea.

Păstrați datele de diagnosticare

Înregistrați ora, metoda, calea, starea, corpul răspunsului și X-Request-Id. Nu înregistrați niciodată valoarea x-api-key. Opriți reluările automate după un număr mic și limitat de încercări și semnalați eșecul pentru analiză.