Treceți la conținut

Rezolvați erorile de validare a cererilor

Folosiți un răspuns 422 pentru a găsi câmpul invalid și a corecta structura sau valoarea cererii.

Actualizat la

Citiți un răspuns 422

Threetone returnează 422 Unprocessable Entity când FastAPI nu poate valida datele de intrare ale cererii. Răspunsul conține un tablou detail. Fiecare element conține:

  • loc: locul unde s-a găsit valoarea invalidă, precum body, query sau path, urmat de numele câmpului.
  • msg: o explicație ușor de citit.
  • type: regula de validare care nu a fost îndeplinită.

Începeți cu loc. Acesta indică partea din cerere care trebuie schimbată.

Corectați cererea

Verificați următoarele înainte de a o trimite din nou:

  1. Metoda HTTP și calea /v1/... corespund operațiunii.
  2. Cererile JSON includ Content-Type: application/json și conțin JSON valid.
  3. Câmpurile obligatorii sunt prezente și numele lor respectă forma din documentație.
  4. Numerele, valorile booleene, tablourile și obiectele folosesc tipurile JSON așteptate.
  5. Valorile enumerărilor și parametrii de interogare se încadrează în valorile și intervalele permise.

De exemplu, punctul final pentru lista agenților acceptă valori page_size de la 1 la 100. O valoare în afara acestui interval produce o eroare de validare al cărei loc indică query și page_size.

Nu reluați cererea nemodificată. Corectați mai întâi valoarea indicată, apoi trimiteți o cerere nouă și păstrați X-Request-Id dacă aceasta eșuează în continuare.