Catálogo de erros
Toda resposta de erro da API segue o Problem Details (RFC 9457), com Content-Type: application/problem+json e as extensões code e correlationId. Versão do catálogo: 1.5.0, atualizado em 2026-10-27.
| code | Status | Título |
|---|---|---|
PASSWORD_CHANGE_REQUIRED | 403 | Troca de senha obrigatória antes do próximo login |
TENANT_SCOPE_MISMATCH | 403 | Tenant fora do escopo do token |
RATE_LIMITED | 429 | Limite de requisições atingido |
UNAUTHENTICATED | 401 | Token ausente, expirado ou inválido |
IDEMPOTENCY_KEY_REQUIRED | 400 | Cabeçalho Idempotency-Key obrigatório |
IDEMPOTENCY_KEY_INVALID_FORMAT | 400 | Formato do Idempotency-Key inválido |
IDEMPOTENCY_OPERATION_IN_PROGRESS | 409 | Operação com esta chave ainda em andamento |
IDEMPOTENCY_KEY_REUSED | 422 | Idempotency-Key reutilizada com corpo diferente |
IDEMPOTENCY_OPERATION_UNCERTAIN | 500 | Resultado da operação não pôde ser confirmado |
TRANSACTION_PAGE_SIZE_TOO_LARGE | 400 | Tamanho de página acima do limite |
TRANSACTION_WINDOW_INVALID | 400 | Período de busca inválido |
TRANSACTION_WINDOW_TOO_LARGE | 400 | Período de busca maior que o máximo permitido |
VALIDATION_FAILED | 422 | Dados da requisição inválidos |
OWNER_NOT_FOUND | 404 | Owner inexistente |
OWNER_INACTIVE | 422 | Owner inativo |
AUTHENTICATION_FAILED | 401 | Autenticação necessária |
INSUFFICIENT_PERMISSION | 403 | Permissão insuficiente |
INVALID_PERMISSION_CLAIM | 403 | Claim de permissão inválida |
UNTRUSTED_INTERNAL_HEADER | 403 | Cabeçalho interno não confiável |
AUDIT_JUSTIFICATION_REQUIRED | 403 | Justificativa de auditoria obrigatória |
RATE_LIMIT_EXCEEDED | 429 | Limite de requisições excedido |