Skip to main content
Verifique o status HTTP antes de processar o corpo da resposta.

​
Códigos HTTP

​
Formato padrão

Todos os erros seguem o formato padrão do OpenDelivery: title descreve o problema e status informa o código HTTP.

​
Limite de requisições

A API aplica limites por minuto, agrupados por tipo de rota. Cada grupo tem a sua própria contagem.

​
Headers da resposta

As respostas bem-sucedidas processadas pelo limitador trazem a contagem atual. Ao atingir o limite, a resposta 429 inclui também o tempo de espera e o instante de liberação:
Erros gerados antes do limitador, como uma falha de autenticação, podem não incluir os headers X-RateLimit-*.

​
Ao receber 429

A API responde com o corpo padrão:
Aguarde o número de segundos informado em Retry-After antes de reenviar. Não repita a chamada imediatamente: novas tentativas dentro da janela continuam recebendo 429.
Monitore X-RateLimit-Remaining e reduza o ritmo antes de atingir o limite. Para cargas grandes, como a leitura de pedidos de um período, distribua as consultas ao longo do tempo em vez de enviá-las em rajada.

​
Erro de autenticação

Ao receber 401 em um endpoint protegido:
  1. solicite outro token em POST /oauth/token;
  2. substitua o token usado pela integração;
  3. reenvie a requisição original.
Não repita a chamada com o mesmo token inválido.