Dados inválidos (400)

Status: 400 Bad Request · type: https://api.nobur.com.br/errors/validation

Quando acontece

• Falta um campo obrigatório, ou um valor não está no formato esperado (CPF, CEP, e-mail, data).
• O corpo não é JSON válido, traz um campo que a operação não aceita ou um valor do tipo errado.
• Um identificador no caminho ou um parâmetro da URL não pôde ser lido, como um limit que não é número.

O que fazer

Corrija a requisição antes de enviá-la de novo; repetir a mesma requisição dá o mesmo erro. Quando o erro é de um campo, a lista errors traz um item por campo, com o nome do campo em field (em notação de ponto, como address.cep) e o motivo em code. Use code para tratar cada caso no seu sistema; detail e message são textos para quem depura, e podem mudar.

Exemplo

{
  "type": "https://api.nobur.com.br/errors/validation",
  "title": "Validation Failed",
  "status": 400,
  "detail": "broker name is required",
  "instance": "/public/v1/brokers",
  "code": "validation.broker.name_required",
  "request_id": "req_abc123",
  "timestamp": "2026-02-15T12:00:00Z",
  "documentation_url": "https://docs.nobur.com.br/docs/api/erros/validation",
  "errors": [
    {
      "field": "name",
      "message": "broker name is required",
      "code": "validation.broker.name_required",
      "resource": "Broker"
    }
  ]
}