跳到正文
LumiPath API
接口参考TikTok 广告

TikTok Ads MCP 访问令牌(权限范围 `mcp:tt4b`)。

供 Lumi/agent 实例连接 TikTok 官方的 Ads MCP 服务。来自专门的 TikTok 广告授权入口(`POST`/`DELETE /api/link/tiktok/mcp`),该入口通过 DCR 注册公开 OAuth 客户端并走 PKCE 授权码流程。这个令牌只能用于 MCP 传输,用它调用 `https://business-api.tiktok.com/open_api/v1.3/...` 会返回 `code: 40105`,那种场景请用 `/api/v1/tiktok/marketing-token`。令牌过期或临近过期时由服务端刷新。从未授权 TikTok Ads MCP 时返回 404 `TIKTOK_MCP_NOT_CONNECTED`;保存的令牌已过期且无法刷新时返回 401 `TOKEN_EXPIRED`。

GET
/api/v1/tiktok/ads-token

鉴权

ApiKeyAuth
header鉴权Bearer <lumi>

Authorization: Bearer lumi_xxx。用户 API Key 拥有完整权限,自主运行的 agent 可以发布视频、取消任务。每个账号只有一把 Key,如需隔离请为 agent 使用单独的 LumiPath 账号。

响应体

成功

application/json
  1. response
success*true
Value intrue
data*
请求示例
curl -X GET 'https://app.lumipath.cn/api/v1/tiktok/ads-token'
响应示例
{  "success": true,  "data": {    "accessToken": "string",    "expiresAt": "2019-08-24T14:15:22Z",    "scope": "string",    "serverUrl": "string"  }}