4224xx · Erro do cliente
HTTP 422 Unprocessable Content
O 422 Unprocessable Content indica requisição bem formada cujos dados não passam nas regras de validação ou de negócio.
O que significa
A sintaxe está correta, mas os dados não passam nas regras de negócio. A requisição tem algum problema — quem chamou precisa corrigir.
Quando usar
Erro de validação de formulário — o mais usado em API REST moderna.
Especificação: RFC 9110
Causas comuns
- Campo obrigatório em branco
- CPF, CNPJ ou e-mail com formato inválido
- Valor fora da faixa permitida
- Combinação de campos que viola uma regra de negócio
Como resolver
- Devolva a lista de erros por campo, e não apenas uma mensagem genérica
- Corrija os dados apontados e reenvie
- Reserve o 400 para requisição que o servidor nem consegue interpretar
Exemplo de resposta
HTTP/1.1 422 Unprocessable Content
Content-Type: application/json
{"erros": [{"campo": "cpf", "mensagem": "dígito verificador inválido"}]}Perguntas frequentes
- 422 ou 400 para erro de validação?
- 422 é o mais preciso quando o JSON está correto e o problema é o conteúdo. O 400 fica reservado para corpo malformado, parâmetro ausente ou Content-Type incompatível.