全部错误使用 RFC 9457 Problem Details。响应中的 code 字段是稳定标识，只追加不修改，程序判断请依据它而非 detail 文案。
| 错误码 | HTTP 状态 | 含义 |
|---|---|---|
forbidden |
403 | 无权访问 |
internal_error |
500 | 服务内部错误 |
invalid_parameter |
400 | 参数取值不合法 |
method_not_allowed |
405 | 请求方法不被允许 |
not_found |
404 | 资源不存在 |
quota_exceeded |
429 | 配额已用尽 |
rate_limit_exceeded |
429 | 请求过于频繁 |
service_unavailable |
503 | 服务暂时不可用 |
unauthorized |
401 | 未提供有效凭据 |
错误响应中的 type 字段指向本站对应的说明页面。