入门指南

认证方式、频率限制与统一的响应格式

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": "具体错误描述文案"
  }
}