TROHUB

TROHUBAPI 文档

TRO & IP RISK CONSOLE

TROHUB 提供一站式的知识产权数据 API 服务,覆盖美国、欧盟外观专利、美国文字商标、图形商标侵权检测、全球版权溯源检索。商标、专利、版权各模块独立检索。

API 服务地址 https://api.trohub.com/v2

认证方式

所有 API 请求均需要通过 API Key 进行身份验证。在密钥管理 ↗需登录页面申请并获取。

Header Authorization : Bearer <your_api_key>

速率限制

为确保服务稳定性,API 的调用频率和并发数都有限制。当超过限制时,请求会被拒绝。

频率限制

每个接口分组有独立的每分钟请求上限。

接口分组 限额
专利反查 30 次/分钟
商标搜索 30 次/分钟
TRO 案件查询 60 次/分钟
侵权检索 10 次/分钟

超出限制时返回 HTTP 429 Too Many Requests:

{ "code": "BUSINESS_RATE_LIMIT_EXCEEDED", "message": "请求频率超限" }

同时响应头会包含当前的限流状态:

响应头 说明
X-RateLimit-Limit 每分钟上限
X-RateLimit-Remaining 当前剩余次数
X-RateLimit-Route 所属模块

并发限制

同一时刻,单个账户最多只能有 3 个请求在处理中。超出时返回:

{ "code": "BUSINESS_RATE_LIMIT_EXCEEDED", "message": "并发请求超限" }

响应格式

所有接口返回统一的 JSON 结构,响应格式见各个接口文档。

通用结构
{ "ok": true | false, "message": "string", "data": { ... }, // 成功时返回 "error": { "code": "…", "details": "…" } // 失败时返回 }

失败时返回 error.code 与 error.details,具体错误码见故障排查。

通用约定

  • 检测类接口是异步的:提交后返回 taskID,再轮询详情接口直到 status 变成 completed / failed;建议 2–3 秒一次。
  • 图片:支持 http(s) 链接或 base64(data URI / 裸串);最长边 ≥ 200px,单张 ≤ 10MB。
  • 结果里的图片地址是临时链接,30 分钟后过期;过期后重新调用详情接口即可拿到新链接。
  • 幂等:提交时带 clientRequestId,同账号同值只会创建一次,重试不会重复扣积分。

联系咨询

诚邀各行业伙伴与优质卖家垂询,我们将竭诚为您提供专业的接入方案与技术支持。

技术接入
技术接入微信二维码
扫码或截图添加微信
商务报价
商务报价微信二维码
扫码或截图添加微信