bad_request

​

O que significa

​

Causas comuns

• Header Idempotency-Key ausente ou vazio no POST /analyses (detail: Idempotency-Key header required). No POST /operations (Motor de Borderô), a key é opcional — a ausência não é erro.
• Motor de CPF/CNPJ: document sem nenhum dígito (detail: document is required and must contain a CPF (11 digits) or CNPJ (14 digits) — masked or unmasked accepted).
• Motor de CPF/CNPJ: document com tamanho errado: depois de remover a máscara, precisa ter 11 dígitos (CPF) ou 14 dígitos (CNPJ).
• Motor de CPF/CNPJ: dígito verificador inválido (detail: CNPJ inválido ou CPF inválido).

​

Como corrigir

• Envie o header Idempotency-Key em todo POST /analyses (e, embora opcional, também no POST /operations quando houver retry). Recomendamos um UUID, amarrado ao ID interno do job (ou do borderô) no seu sistema.
• Envie document com 11 dígitos (CPF) ou 14 dígitos (CNPJ). Máscara é aceita: caracteres não numéricos são removidos.
• Valide o dígito verificador do documento antes de enviar.
• Depois de corrigir o body, use uma nova Idempotency-Key. A mesma key com body diferente retorna 409 idempotency_conflict.

​

Exemplo

{
  "type": "https://docs.sherlocker.com.br/problems/bad_request",
  "title": "Bad Request",
  "status": 400,
  "code": "bad_request",
  "detail": "Idempotency-Key header required",
  "instance": "/v1?request_id=req-uuid-here"
}

​

Relacionado

• Erros da API
• Idempotência
• Quickstart