通用说明
所有需要 API Key 认证的接口，在以下情况都会返回通用错误：
| 场景 | 错误码 | HTTP 状态码 | 说明 |
|---|
| API Key 无效/已过期/被撤销 | UNAUTHORIZED_AUTH_REQUIRED | 401 | 缺少 X-API-Key 请求头、Key 不存在或已失效 |
| 用户被禁用 | UNAUTHORIZED_USER_INACTIVE | 401 | 账户已被停用 |
| 速率超限 | BUSINESS_RATE_LIMIT_EXCEEDED | 429 | 每分钟请求次数超限（各模块独立计数） |
| 并发超限 | BUSINESS_RATE_LIMIT_EXCEEDED | 429 | 同时处理中的请求数超限 |
| 配额不足 | BUSINESS_INSUFFICIENT_QUOTA | 403 | 账户积分/额度不足以执行此操作 |
| 请求体 JSON 解析失败或参数错误 | VALIDATION_BAD_REQUEST | 400 | JSON 格式无效、缺少必填字段或参数值不合法 |
| 服务器内部错误 | INTERNAL_ERROR_UNKNOWN | 500 | 服务器繁忙，请稍后重试 |
完整错误码索引
| 错误码 | 描述 |
|---|
UNAUTHORIZED_AUTH_REQUIRED | 认证无效，检查 X-API-Key 是否正确 |
UNAUTHORIZED_USER_INACTIVE | 账户已被停用 |
BUSINESS_RATE_LIMIT_EXCEEDED | 请求过快，按频率限制调用（60次/分） |
BUSINESS_INSUFFICIENT_QUOTA | 余额不足，前往个人中心补充配额 |
BUSINESS_RECORDS_NOT_FOUND | 记录不存在 |
BUSINESS_TRO_RECENT_QUERY_FAILED | 查询最近 TRO 案件失败 |
BUSINESS_TRO_ENTRIES_QUERY_FAILED | 查询案件条目失败 |
BUSINESS_ELEMENT_SEARCH_UNAUTHORIZED | 无权访问/操作该检索任务 |
BUSINESS_ELEMENT_SEARCH_TRADEMARK_AIAUTOCUT_DISABLED | 商标 AI 切图已禁用 |
BUSINESS_ELEMENT_SEARCH_DESIGN_PATENT_AIAUTOCUT_DISABLED | 专利 AI 切图已禁用 |
BUSINESS_ELEMENT_SEARCH_DESIGN_PATENT_REMOVEBG_DISABLED | 专利去背景已禁用 |
BUSINESS_ELEMENT_SEARCH_COPYRIGHT_AIAUTOCUT_DISABLED | 版权 AI 切图已禁用 |
VALIDATION_BAD_REQUEST | JSON 格式无效或参数错误 |
VALIDATION_PATENT_NUMBER_INVALID | 专利号格式无效，仅支持 D 或 USD 开头后接 6-7 位数字 |
VALIDATION_TRO_DOCKET_ID_REQUIRED | docketID 不能为空 |
VALIDATION_ELEMENT_SEARCH_TASK_ID_REQUIRED | taskID 不能为空 |
VALIDATION_ELEMENT_SEARCH_MAX_IMAGES_EXCEEDED | 图片数量超出上限 |
VALIDATION_ELEMENT_SEARCH_SCOPE_INVALID | 检索类型配置无效或未启用 |
INTERNAL_ERROR_UNKNOWN | 服务器繁忙，请稍后重试 |