Developer Portal

Erros e requestId

Trate códigos estáveis e use requestId para diagnóstico.

Atualizado em 05/07/2026
{
  "error": {
    "code": "INSUFFICIENT_SCOPE",
    "message": "A credencial não possui o scope products:write.",
    "details": { "requiredScope": "products:write" }
  },
  "meta": { "requestId": "req_019..." }
}
  • 400: payload ou regra inválida.
  • 401: token ausente, expirado ou revogado.
  • 403: scope ou tenant não autorizado.
  • 404: recurso inexistente no escopo.
  • 409: conflito de idempotência ou mapeamento.
  • 429: rate limit excedido.