リクエストの入力エラーを解決する

422レスポンスを読む

FastAPIがリクエスト入力を検証できない場合、Threetoneは422 Unprocessable Entityを返します。レスポンスにはdetail配列が含まれます。各項目には次の情報があります。

• loc: 無効な値の位置です。body、query、pathなどに続いてフィールド名が示されます。
• msg: 人が読める形式の説明です。
• type: 失敗した検証ルールです。

まずlocを確認してください。変更が必要なリクエスト部分を特定できます。

リクエストを修正する

再送する前に次の点を確認してください。

1. HTTPメソッドと/v1/...パスが操作の指定と一致している。
2. JSONリクエストにContent-Type: application/jsonが含まれ、有効なJSONが送信されている。
3. 必須フィールドがあり、フィールド名がドキュメントの表記と一致している。
4. 数値、真偽値、配列、オブジェクトが期待されるJSON型になっている。
5. 列挙値とクエリパラメーターが許可された値および範囲を満たしている。

たとえばエージェント一覧エンドポイントは、page_sizeの値として1から100を受け付けます。この範囲外の値を送ると、locにqueryとpage_sizeを示す検証エラーが返されます。

修正していないリクエストを再試行しないでください。示された値を直してから新しいリクエストを送り、失敗が続く場合に備えてX-Request-Idを保存してください。