Doorgaan naar inhoud

Validatiefouten in aanvragen oplossen

Gebruik een 422-respons om het ongeldige veld te vinden en de structuur of waarde van de aanvraag te corrigeren.

Bijgewerkt

Een 422-respons lezen

Threetone retourneert 422 Unprocessable Entity als FastAPI de invoer van een aanvraag niet kan valideren. De respons heeft een detail-array. Elk item bevat:

  • loc: waar de ongeldige waarde is gevonden, bijvoorbeeld in body, query of path, gevolgd door de veldnaam.
  • msg: een uitleg voor de gebruiker.
  • type: de validatieregel waaraan niet is voldaan.

Begin bij loc. Dit verwijst naar het deel van de aanvraag dat moet worden aangepast.

De aanvraag corrigeren

Controleer het volgende voordat je de aanvraag opnieuw verstuurt:

  1. De HTTP-methode en het /v1/...-pad komen overeen met de bewerking.
  2. JSON-aanvragen bevatten Content-Type: application/json en geldige JSON.
  3. Verplichte velden zijn aanwezig en veldnamen gebruiken de gedocumenteerde spelling.
  4. Getallen, booleans, arrays en objecten hebben de verwachte JSON-typen.
  5. Enumwaarden en queryparameters voldoen aan de toegestane waarden en bereiken.

Het endpoint voor de lijst met agents accepteert bijvoorbeeld waarden van 1 tot en met 100 voor page_size. Een waarde buiten dat bereik veroorzaakt een validatiefout waarvan loc naar query en page_size verwijst.

Probeer de ongewijzigde aanvraag niet opnieuw. Corrigeer eerst de aangegeven waarde en verstuur daarna een nieuwe aanvraag. Bewaar de X-Request-Id als deze opnieuw mislukt.

Gerelateerde artikelen