Pular para o conteudo principal
OrNexus
Erros

Problem Details e request id

Erros seguem RFC 7807 para facilitar observabilidade e suporte sem expor PII em logs.

json
{
  "type": "https://docs.ornexus.com/errors/insufficient-scope",
  "title": "Insufficient scope",
  "status": 403,
  "detail": "Required scope: campaigns:dangerous",
  "instance": "/v1/campaigns/cmp_.../start",
  "request_id": "req_..."
}

401

Chave ausente, invalida, expirada ou revogada.

403

Scope, beta whitelist ou aprovacao insuficiente.

409

Conflito de idempotencia ou estado do recurso.

429

Rate limit atingido. Use Retry-After quando presente.

Lide com retry de forma idempotente

Para metodos POST com efeito colateral, envie o header Idempotency-Key para garantir que retentativas nao dupliquem operacoes.

Nao retransmita PII em logs

O campo request_id e suficiente para correlacao com nosso suporte. Nunca cole payloads completos.

Perguntas frequentes