错误码手册
API 返回的错误码说明与处理建议。
| 错误码 | HTTP | 说明 | 处理建议 |
|---|---|---|---|
| INVALID_PARAMETER | 400 | 请求参数无效 | 检查参数格式 |
| UNAUTHORIZED | 401 | 未提供 API Key | 添加 Authorization 头 |
| FORBIDDEN | 403 | 权限不足 | 检查 Key 的 scopes |
| SKILL_NOT_FOUND | 404 | Skill 不存在 | 确认 skillId 是否正确 |
| VERSION_NOT_FOUND | 404 | 版本不存在 | 确认 version 是否正确 |
| RATE_LIMITED | 429 | 超出限流 | 降低请求频率，参考 X-RateLimit-* 头 |
| INTERNAL_ERROR | 500 | 服务器内部错误 | 稍后重试，附带 request_id 反馈 |