Lidar com limites de pedidos e erros do servidor

Lide com uma resposta 429

Um pedido sujeito a limitação devolve 429 Too Many Requests com detail.status definido como rate_limit_exceeded. Leia os cabeçalhos da resposta antes de voltar a tentar:

• Retry-After indica o tempo mínimo de espera, em segundos, para um pedido rejeitado.
• X-RateLimit-Limit indica o limite do grupo.
• X-RateLimit-Remaining indica quantos pedidos restam.
• X-RateLimit-Reset indica quando o grupo é reposto.

Aguarde o período indicado por Retry-After e depois volte a tentar com espera exponencial e variação aleatória. Reduza os pedidos paralelos e coloque o trabalho numa fila, em vez de enviar uma rajada assim que a janela for reposta.

Lide com erros do servidor

Numa resposta 500, o corpo público contém um erro genérico e um request_id; os detalhes internos da exceção não são devolvidos. Uma resposta 503 pode indicar que um serviço necessário está temporariamente indisponível.

Repita pedidos apenas de leitura com uma espera limitada. Antes de repetir um pedido de criação, atualização, pagamento ou outra alteração de estado, determine se a primeira tentativa foi concluída. Um tempo limite excedido ou uma resposta 5xx não prova que a alteração falhou, e uma repetição imediata pode duplicar o trabalho.

Preserve os dados de diagnóstico

Registe a hora, o método, o caminho, o estado, o corpo da resposta e o X-Request-Id. Nunca registe o valor de x-api-key. Interrompa as repetições automáticas após um número pequeno e limitado de tentativas e apresente a falha para análise.