Saltar para o conteúdo

Resolver erros de validação de pedidos

Utilize uma resposta 422 para identificar o campo inválido e corrigir a estrutura ou o valor do pedido.

Atualizado em

Leia uma resposta 422

A Threetone devolve 422 Unprocessable Entity quando o FastAPI não consegue validar os dados de entrada de um pedido. A resposta contém uma lista detail. Cada elemento contém:

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

Comece por loc. Indica a parte do pedido que tem de ser alterada.

Corrija o pedido

Antes de o enviar novamente, verifique o seguinte:

  1. O método HTTP e o caminho /v1/... correspondem à operação.
  2. Os pedidos JSON incluem Content-Type: application/json e contêm JSON válido.
  3. Os campos obrigatórios estão presentes e os seus nomes têm a grafia documentada.
  4. Números, valores booleanos, listas e objetos utilizam os tipos JSON esperados.
  5. Os valores de enumerações e os parâmetros de consulta respeitam os valores e intervalos permitidos.

Por exemplo, o endpoint da lista de agentes aceita valores page_size entre 1 e 100. Um valor fora desse intervalo causa um erro de validação cujo loc identifica query e page_size.

Não repita o pedido sem alterações. Corrija primeiro o valor indicado, envie um novo pedido e conserve o respetivo X-Request-Id se ainda falhar.

Artigos relacionados