Docs错误码

错误码 (Errors)

FindIP API 使用标准 HTTP 状态码,并返回包含错误详情的 JSON 响应。

错误响应结构

所有错误响应均遵循以下结构:

JSON

{
"detail": "可读的错误信息"
}

代码	状态	说明
`200`	OK	请求成功。
`300`	Multiple Choices	文档 ID 匹配多个专利。(参阅文档详情 API)

代码	状态	说明
`400`	Bad Request	请求格式错误。缺少必填字段(如 `query`)或参数类型/取值错误。
`401`	Unauthorized	缺少或无效的 API 密钥。请检查 Authorization 头。
`403`	Forbidden	API 密钥有效但无此操作权限。
`404`	Not Found	请求的资源不存在(例如:不存在的文档 ID)。
`429`	Too Many Requests	已超过月度检索额度,或触发每分钟 60 次的速率限制。请升级套餐或等待下个结算周期重置。

代码	状态	说明
`500`	Internal Server Error	服务器发生未预期错误。请稍后重试。
`503`	Service Unavailable	服务器暂时不可用(维护或负载过高)。

401 Unauthorized

{
"detail": "Invalid API key"
}

请确认请求中包含 Authorization: Bearer psk_live_xxx 头。

429 Too Many Requests

{
"detail": "Monthly limit exceeded"
}

已达到月度检索额度。额度按结算日每月自动重置。详情查询、附图、编号查询不计入额度。请在使用量仪表盘查看当前状态。

400 Bad Request

{
"detail": "Field 'query' is required"
}

404 Not Found

{
"detail": "Document not found"
}

请检查 publication_id 的格式。必须使用包含国家代码的完整 ID(例如 US12261291B2,而非 12261291)。