Vai al contenuto

Risolvi gli errori di convalida delle richieste

Usa una risposta 422 per individuare il campo non valido e correggere la struttura o il valore della richiesta.

Aggiornato

Leggi una risposta 422

Threetone restituisce 422 Unprocessable Entity quando FastAPI non riesce a convalidare i dati di una richiesta. La risposta contiene un array detail. Ogni elemento include:

  • loc: la posizione del valore non valido, ad esempio body, query o path, seguita dal nome del campo.
  • msg: una spiegazione leggibile.
  • type: la regola di convalida non rispettata.

Inizia da loc: indica quale parte della richiesta deve cambiare.

Correggi la richiesta

Prima di inviarla di nuovo, verifica che:

  1. Il metodo HTTP e il percorso /v1/... corrispondano all'operazione.
  2. Le richieste JSON includano Content-Type: application/json e contengano JSON valido.
  3. I campi obbligatori siano presenti e i nomi dei campi seguano la grafia documentata.
  4. Numeri, valori booleani, array e oggetti usino i tipi JSON previsti.
  5. I valori enum e i parametri di query rispettino i valori e gli intervalli consentiti.

Per esempio, l'endpoint per l'elenco degli agenti accetta valori page_size da 1 a 100. Un valore fuori intervallo produce un errore di convalida il cui loc indica query e page_size.

Non ripetere la richiesta senza modificarla. Correggi prima il valore indicato, quindi invia una nuova richiesta e conserva X-Request-Id se il problema persiste.

Articoli correlati