Aller au contenu

Résoudre les erreurs de validation des requêtes

Utilisez la réponse 422 pour trouver le champ invalide et corriger la structure ou la valeur de la requête.

Mis à jour le

Lire une réponse 422

Threetone renvoie 422 Unprocessable Entity lorsque FastAPI ne peut pas valider l'entrée. La réponse contient un tableau detail; chaque élément comprend :

  • loc : l'emplacement de la valeur invalide, par exemple body, query ou path, suivi du nom du champ.
  • msg : une explication lisible.
  • type : la règle de validation non respectée.

Commencez par loc pour savoir quelle partie de la requête modifier.

Corriger la requête

Avant un nouvel envoi, vérifiez :

  1. La méthode HTTP et le chemin /v1/... correspondent à l'opération.
  2. Les requêtes JSON portent Content-Type: application/json et contiennent un JSON valide.
  3. Tous les champs requis sont présents, avec les noms documentés.
  4. Les nombres, booléens, tableaux et objets utilisent les types JSON attendus.
  5. Les valeurs d'énumération et paramètres de requête respectent les valeurs et plages admises.

Par exemple, le point de terminaison de liste des agents accepte page_size de 1 à 100. Hors de cette plage, loc désigne query et page_size.

Ne renvoyez pas la même requête sans correction. Modifiez d'abord la valeur indiquée et gardez le nouveau X-Request-Id si l'échec persiste.