Gestiona els límits de velocitat i els errors del servidor

Gestiona una resposta 429

Una sol·licitud limitada retorna 429 Too Many Requests i estableix detail.status a rate_limit_exceeded. Llegeix les capçaleres de resposta abans de tornar-ho a provar:

• Retry-After indica el temps mínim d'espera, en segons, abans de tornar a enviar una sol·licitud rebutjada.
• X-RateLimit-Limit indica el límit del grup.
• X-RateLimit-Remaining indica quantes sol·licituds queden.
• X-RateLimit-Reset indica quan es reinicia el grup.

Espera el temps indicat per Retry-After i torna-ho a provar amb una espera exponencial i variació aleatòria. Redueix les sol·licituds paral·leles i posa la feina en cua en comptes d'enviar un gran nombre de sol·licituds tan bon punt es reinicia el període.

Gestiona els errors del servidor

En una resposta 500, el cos públic conté un error genèric i un request_id; no s'hi retornen detalls interns de l'excepció. Una resposta 503 pot indicar que un servei necessari no està disponible temporalment.

Torna a provar les sol·licituds de només lectura amb una espera acotada. Abans de tornar a provar una sol·licitud de creació, actualització, pagament o qualsevol altra que canviï l'estat, determina si el primer intent s'ha completat. Un temps d'espera esgotat o una resposta 5xx no demostra que una modificació hagi fallat, i repetir-la immediatament pot duplicar la feina.

Conserva les dades de diagnòstic

Registra l'hora, el mètode, la ruta, l'estat, el cos de la resposta i X-Request-Id. No registris mai el valor de x-api-key. Atura els intents automàtics després d'un nombre petit i limitat d'intents, i mostra l'error perquè es revisi.