API

错误处理

校验详情可能包含 error.details.errors,条目带有 loc、msg、type。

按状态与错误码处理

状态含义与处理
401缺失或无效认证,检查当前密钥。
402credit_insufficient,补充点数或检查订阅。
403forbidden,该凭证无权执行操作。
404resource_not_found,检查路径、标识与覆盖。
405method_not_allowed,检查 HTTP 方法与 Allow 头。
422validation_error,修正字段约束再重试。
429rate_limited,按 Retry-After 等待。
500internal_error,保留请求 ID,持续失败时报告。
503dependency_unavailable,稍后退避重试。

校验详情可能包含 error.details.errors,条目带有 loc、msg、type。响应不一定回显输入,不要依赖英文错误文字做程序判断。

失败的价格请求不扣点数,但丢失成功响应是另一种情况,见重试。