Pular para o conteúdo

Resolva erros de validação de solicitações

Use a resposta 422 para encontrar o campo inválido e corrigir a estrutura ou o valor da solicitação.

Atualizado em

Leia uma resposta 422

A Threetone devolve 422 Unprocessable Entity quando o FastAPI não consegue validar a entrada. A resposta traz um array detail, em que cada item contém:

  • loc: local do valor inválido, como body, query ou path, seguido pelo nome do campo.
  • msg: explicação legível.
  • type: regra de validação que falhou.

Comece por loc para saber o que mudar.

Corrija a solicitação

Antes de reenviar, confira:

  1. O método HTTP e o caminho /v1/... correspondem à operação.
  2. Solicitações JSON incluem Content-Type: application/json e JSON válido.
  3. Os campos obrigatórios estão presentes e os nomes seguem a documentação.
  4. Números, booleanos, arrays e objetos usam os tipos JSON esperados.
  5. Valores enumerados e parâmetros de consulta respeitam os valores e intervalos permitidos.

Por exemplo, o endpoint de lista de agentes aceita page_size de 1 a 100. Fora desse intervalo, loc aponta query e page_size.

Não repita uma solicitação sem alterá-la. Corrija o valor indicado, envie outra e guarde o novo X-Request-Id se ainda falhar.

Artigos relacionados