概览

TRAE 企业版 OpenAPI 为企业管理员提供了一套标准化的 HTTP 接口，用于在企业自有系统中集成 TRAE 的人员管理、数据分析与日志管理能力。

套餐要求

旗舰版。

功能模块

目前 TRAE 企业版接口支持的功能如下：

• 成员管理：邀请新成员、查询成员列表、移除成员。
• 使用数据统计：获取企业的活跃成员数，企业整体及指定成员的 AI 用量、MCP 调用排行，便于进行用量分析和成本核算。
• 审计与日志：拉取 OpenAPI 调用日志和管理员操作日志，满足合规审计需求。

调用流程

调用 TRAE 企业版接口的通用流程如下。详见鉴权。

1. 创建应用：在 TRAE 企业版控制台中创建应用，并为应用配置所需的权限，从而获取相应的 app_id 与 app_secret。
2. 获取访问令牌：使用 app_id 和 app_secret 调用鉴权接口，获取 access_token。
3. 调用业务接口：在请求头中通过 Authorization: Bearer {access_token} 携带访问令牌，调用对应的业务接口。
4. 解析响应：处理响应；遇到异常时，参考错误码进行排查与重试。

请求地址

所有接口的请求地址均由 Base URL 和接口路径两部分组成。

• Base URL：
  • 若你的企业未配置专属域名，统一使用 https://console.enterprise.trae.cn。
  • 若你的企业已配置专属域名，使用该专属域名。
• 接口路径：所有接口的路径均以 /openapi/v1/ 为前缀。

请求频率限制

为保障服务稳定性，API 调用存在频率限制。
读操作接口的调用频率默认不超过 2 QPS，写操作接口不超过 1 QPS。
当请求频率超过限制时，API 将返回 HTTP 429 和 code: 64290。同时，响应头会包含 Retry-After 字段。