解决请求验证错误

查看 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。