DevToolPal
PT
4xx Erros do cliente

422 Unprocessable Content

Conteúdo não processável

O que significa

A requisição está bem formada, mas contém erros semânticos, então o servidor não consegue processá-la. Antes Unprocessable Entity.

Causas comuns

  • A validação falhou (e-mail inválido, campo obrigatório ausente)
  • Regra de negócio violada
  • Erros de validação do Rails ou Laravel

Como resolver

Se você é o cliente ou visitante

Leia os erros por campo no corpo, corrija os valores e reenvie.

Se você mantém o site ou a API

Retorne erros por campo legíveis por máquina para que os formulários possam destacá-los.

Resposta de exemplo

HTTP/1.1
HTTP/1.1 422 Unprocessable Content
Date: Tue, 07 Oct 2025 09:30:00 GMT
Server: nginx
Content-Type: application/problem+json

{
  "type": "about:blank",
  "title": "Unprocessable Content",
  "status": 422,
  "errors": [
    {
      "field": "email",
      "message": "must be a valid email address"
    }
  ]
}

Especificação

RFC 9110 §15.5.21

Perguntas frequentes

› Erros de validação devem usar 400 ou 422?

Muitas APIs usam 422 para validação e 400 para entrada que não pode ser interpretada. Ambos são válidos; seja consistente.

› 422 é só para WebDAV?

Começou no WebDAV, mas a RFC 9110 agora o define para HTTP em geral.