Przejdź do treści

Rozwiąż błędy walidacji żądań

Użyj odpowiedzi 422, aby znaleźć nieprawidłowe pole i poprawić strukturę lub wartość żądania.

Zaktualizowano

Odczytaj odpowiedź 422

Threetone zwraca 422 Unprocessable Entity, gdy FastAPI nie może zwalidować danych wejściowych żądania. Odpowiedź zawiera tablicę detail. Każdy element ma pola:

  • loc: miejsce, w którym znaleziono nieprawidłową wartość, np. body, query lub path, a następnie nazwę pola.
  • msg: zrozumiałe dla człowieka wyjaśnienie.
  • type: regułę walidacji, która nie została spełniona.

Zacznij od loc. Wskazuje część żądania, którą należy zmienić.

Popraw żądanie

Przed ponownym wysłaniem sprawdź, czy:

  1. Metoda HTTP i ścieżka /v1/... odpowiadają danej operacji.
  2. Żądania JSON zawierają Content-Type: application/json i prawidłowy JSON.
  3. Obecne są wymagane pola, a ich nazwy mają pisownię zgodną z dokumentacją.
  4. Liczby, wartości logiczne, tablice i obiekty mają oczekiwane typy JSON.
  5. Wartości enum i parametry zapytania mieszczą się w dozwolonych wartościach i zakresach.

Na przykład endpoint listy agentów akceptuje wartości page_size od 1 do 100. Wartość spoza tego zakresu powoduje błąd walidacji, którego loc wskazuje query i page_size.

Nie ponawiaj niezmienionego żądania. Najpierw popraw wskazaną wartość, a potem wyślij nowe żądanie i zachowaj X-Request-Id, jeśli nadal wystąpi błąd.

Powiązane artykuły