按关键词 / 案件号取某件 TRO 案件下的条目:被告名单、附件、涉及品牌。
查询案件条目
POST /tro/entries请求参数
| 参数 | 类型 | 必填 | 说明 |
|---|---|---|---|
docketID | string | ✅ | — |
请求示例
{
"docketID": "3f2b1c4d5e6f47a8b9c0d1e2f3a4b5c6"
} cURLPython
curl -X POST "https://api.trohub.com/v2/tro/entries" -H "Authorization: Bearer YOUR_API_KEY" -H "Content-Type: application/json" -d '{"docketID":"3f2b1c4d5e6f47a8b9c0d1e2f3a4b5c6"}'import requests
url = "https://api.trohub.com/v2/tro/entries"
headers = {"Authorization": "Bearer YOUR_API_KEY"}
payload = {
"docketID": "3f2b1c4d5e6f47a8b9c0d1e2f3a4b5c6"
}
r = requests.post(url, headers={**headers, "Content-Type": "application/json"}, json=payload)
print(r.json()) 可能的错误
| HTTP | 错误码 | 说明 |
|---|---|---|
| 400 | VALIDATION_*(见 message) | 请求数据无效(HTTP 400) |
| 401 | UNAUTHORIZED_AUTH_REQUIRED | 缺少 API Key、Key 无效或被封禁(HTTP 401),错误码 UNAUTHORIZED_AUTH_REQUIRED。 |
| 429 | BUSINESS_RATE_LIMIT_EXCEEDED / RATE_LIMITER_UNAVAILABLE | 请求频率或并发数超限(HTTP 429),错误码 BUSINESS_RATE_LIMIT_EXCEEDED。 限流校验不可用时返回 503(RATE_LIMITER_UNAVAILABLE)。 限流是动态的:额度由「你的 API 档位 × 接口所属的桶」决定, 所以同一个接口对不同调用者可能是不同的数值,这里不给出固定数字。 两处可以看到实际生效值: 1. 每次响应的 X-RateLimit-* 响应头(当次生效的次数、窗口、命中哪一档额度); 2. GET /v2/quota/mine(带 API Key,返回你每个额度的生效值); 另有 GET /v2/quota/config(公开)给出未分档的基线额度。 计数口径:按账号计 —— 同一账号下的所有 API Key 共享同一份额度, 多开一个 Key 不会获得额外配额。接口桶是分开计数的(例如「提交检测」与 「轮询结果」是两个桶),所以轮询不会吃掉提交的额度。 |
| 500 | INTERNAL_ERROR_UNKNOWN | 服务器内部错误(HTTP 500),错误码 INTERNAL_ERROR_UNKNOWN |