API 简介

TROHUB API 服务概览,包含认证方式、频率限制与响应格式说明

T

TROHUB API

v1.0.0

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

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

认证方式

所有 API 请求均需要通过 API Key 进行身份验证。在"密钥管理"页面申请并获取。
Header X-API-Key your_api_key_here

频率限制

为保障系统稳定性,系统对 API 的调用频次与异步任务执行的并发数进行了统一管理。
网关请求频率限制
60 次 / 分钟

以分钟为单位进行重置。此限制适用于所有 API 接口。

异步任务单用户并发限制
3 个任务并发运行

超出部分将自动弹性排队,3 秒后延迟重试。


频率限制 HTTP 响应头

响应头 说明 示例
X-RateLimit-Limit 一分钟内允许的最大请求次数 60
X-RateLimit-Remaining 当前剩余可用请求次数 57
X-RateLimit-Reset 限额重置的 Unix 时间戳(秒) 1718714400

响应格式

所有接口返回统一的 JSON 结构。
成功响应
{
  "ok": true,
  "message": "成功",
  "responseType": "v2",
  "data": { ... }
}
失败响应
{
  "ok": false,
  "message": "错误描述",
  "responseType": "v2",
  "error": {
    "code": "ERROR_CODE",
    "details": "具体错误描述文案"
  }
}