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

TikTok Marketing API(Business API)访问令牌。

供 Lumi/agent 实例直接调用 `https://business-api.tiktok.com/open_api/v1.3/...`(作为 `Access-Token` 请求头发送)。来自 TikTok Marketing 授权入口(`POST`/`DELETE /api/link/tiktok/marketing`),该入口使用具备 Marketing API 权限(广告账户信息、广告系列/广告组/广告、广告数据报表)的开发者应用,走 TikTok for Business 授权码流程。长期有效:没有 refresh token、不会过期,直到用户在 TikTok Business Center 撤销或重新授权。`data.advertiserIds` 是用户在授权页授予的广告账户。如果从未在 LumiPath 授权或已断开,返回 404 `TIKTOK_MARKETING_NOT_CONNECTED`,请在 LumiPath 的「广告」页面重新授权。

GET
/api/v1/tiktok/marketing-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/marketing-token'
响应示例
{  "success": true,  "data": {    "accessToken": "string",    "advertiserIds": [      "string"    ],    "scope": [      0    ],    "authorizedAt": "2019-08-24T14:15:22Z",    "appId": "string"  }}