API 服务地址
https://*.api.trohub.com/v1 认证方式
所有 API 请求均需要通过 API Key 进行身份验证。在"密钥管理"页面申请并获取。
Header
X-API-Key → your_api_key_here 频率限制
为保障系统稳定性，系统对 API 的调用频次与异步任务执行的并发数进行了统一管理。
网关请求频率限制
60 次 / 分钟
以分钟为单位进行重置。此限制适用于所有 API 接口。
异步任务单用户并发限制
3 个任务并发运行
超出部分将自动弹性排队，3 秒后延迟重试。
频率限制 HTTP 响应头
响应格式
所有接口返回统一的 JSON 结构。
成功响应
{
"ok": true,
"message": "成功",
"responseType": "v2",
"data": { ... }
} 失败响应
{
"ok": false,
"message": "错误描述",
"responseType": "v2",
"error": {
"code": "ERROR_CODE",
"details": "具体错误描述文案"
}
}