Postupite s ograničenjima brzine i greškama servera

Postupite s odgovorom 429

Ograničeni zahtjev vraća 429 Too Many Requests uz detail.status postavljen na rate_limit_exceeded. Prije ponovnog pokušaja pročitajte zaglavlja odgovora:

• Retry-After navodi minimalno vrijeme čekanja u sekundama prije ponovnog slanja odbijenog zahtjeva.
• X-RateLimit-Limit prikazuje ograničenje grupe.
• X-RateLimit-Remaining prikazuje broj preostalih zahtjeva.
• X-RateLimit-Reset prikazuje kada se ograničenje grupe resetuje.

Sačekajte vrijeme navedeno u Retry-After, a zatim pokušajte ponovo uz eksponencijalno povećanje čekanja i nasumičnu varijaciju. Smanjite broj paralelnih zahtjeva i stavite posao u red umjesto da šaljete veliki broj zahtjeva čim se vremenski prozor resetuje.

Postupite s greškama servera

Kod odgovora 500, javno tijelo sadrži generičku grešku i request_id; interni detalji izuzetka se ne vraćaju. Odgovor 503 može značiti da je potrebna usluga privremeno nedostupna.

Za zahtjeve koji samo čitaju podatke ponovite pokušaj uz ograničeno povećanje čekanja. Prije ponovnog slanja zahtjeva za kreiranje, ažuriranje, plaćanje ili drugu izmjenu stanja utvrdite je li prvi pokušaj dovršen. Vremensko ograničenje ili odgovor 5xx ne dokazuju da izmjena nije uspjela, a trenutno ponavljanje može duplicirati posao.

Sačuvajte dijagnostičke podatke

Zabilježite vrijeme, metod, putanju, status, tijelo odgovora i X-Request-Id. Nikada nemojte zapisivati vrijednost x-api-key. Zaustavite automatske ponovne pokušaje nakon malog, unaprijed ograničenog broja pokušaja i prikažite grešku radi pregleda.