解決請求驗證錯誤

查看 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. 列舉值和查詢參數符合允許的值及範圍。

例如，代理清單端點接受 1 到 100 之間的 page_size 值。超出此範圍會產生驗證錯誤，其中的 loc 會標明 query 和 page_size。

不要重試未經修改的請求。先修正指出的值，再傳送新請求；如果仍失敗，請保留其 X-Request-Id。