Postupanje s ograničenjima učestalosti i pogreškama poslužitelja

Postupanje s odgovorom 429

Ograničeni zahtjev vraća 429 Too Many Requests, a detail.status ima vrijednost rate_limit_exceeded. Prije ponovnog pokušaja pročitajte zaglavlja:

• Retry-After daje najkraće čekanje u sekundama nakon odbijanja.
• X-RateLimit-Limit prikazuje ograničenje skupine.
• X-RateLimit-Remaining prikazuje preostale zahtjeve.
• X-RateLimit-Reset prikazuje kada se skupina resetira.

Pričekajte Retry-After, zatim pokušajte ponovno uz eksponencijalno povećavanje čekanja i slučajno odstupanje. Smanjite paralelne zahtjeve i stavite posao u red umjesto naglog slanja nakon resetiranja razdoblja.

Postupanje s pogreškama poslužitelja

Za odgovor 500 javno tijelo sadrži opću pogrešku i request_id, ali ne i pojedinosti interne iznimke. 503 može značiti da je nužna usluga privremeno nedostupna.

Zahtjeve samo za čitanje ponovite uz ograničen broj pokušaja i čekanje. Prije ponavljanja izrade, ažuriranja, plaćanja ili druge promjene stanja provjerite je li prvi pokušaj dovršen. Istek vremena ili 5xx ne dokazuju neuspjeh promjene; trenutačno ponavljanje može duplicirati posao.

Sačuvajte dijagnostičke podatke

Zabilježite vrijeme, metodu, putanju, status, tijelo odgovora i X-Request-Id. Nikada ne zapisujte vrijednost x-api-key. Prekinite automatske pokušaje nakon malog ograničenog broja i prijavite neuspjeh radi provjere.