Erros

Todo erro da API vem em application/problem+json (RFC 9457), com um codigo estável para o seu código tratar e um requisicao_id para o suporte. A mensagem é genérica: nunca traz detalhe interno. A exceção é o 405 (método errado numa rota que existe): ele vem do servidor, sem corpo e sem codigo.

{
  "type": "https://precificador3d.com.br/docs/api/erros/dados_invalidos",
  "title": "Dados inválidos",
  "status": 400,
  "codigo": "dados_invalidos",
  "detail": "Confira os campos indicados.",
  "requisicao_id": "req_01HF8Z3K2M9QX",
  "erros": [
    { "campo": "itens[0].quantidade", "codigo": "fora_da_faixa" }
  ]
}

• type é o endereço da explicação do erro neste site.
• erros só vem em validação, um por campo, sem repetir o valor enviado.
• limite só vem no 429: chave, conta, global ou ip.
• Toda resposta, de erro ou não, traz o cabeçalho Precificador-Requisicao-Id.

Como tratar

• 4xx (fora 408, 409 e 429): corrija antes de repetir. Repetir igual dá o mesmo erro.
• 408: o corpo chegou devagar demais; repita com a mesma Idempotency-Key.
• 409 e 429: espere os segundos de Retry-After e repita (com a mesma Idempotency-Key, se for POST).
• 5xx: repita com espera crescente (1 s, 2 s, 4 s…), sempre com a mesma Idempotency-Key.
• Trate pelo codigo, não pelo texto: o texto pode mudar.

Todos os códigos

Esta página em Markdown · llms.txt