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

带广告权限的 Facebook 令牌(个人或系统用户)。

供 Lumi/agent 实例注入到 Meta Ads MCP。来自 Facebook OAuth 回调中专门的广告入口(`POST`/`DELETE /api/link/facebook/ads`),与同一 LumiPath 用户在社交页面连接的 Facebook 主页互不影响。要求广告入口使用的 Meta 应用 Facebook Login for Business 配置授予 `ads_management`/`ads_read`/`business_management`。`data.tokenType` 为 `user`(个人长期令牌,userId/userName 有值,businessId 为 null,当前默认,2026-08-23 产品决定)或 `system_user`(BISU,businessId 有值,userId/userName 为 null,通过环境开关保留,目前不是默认)。从未授权广告或授权时没有广告权限,返回 404 `META_ADS_NOT_CONNECTED`;保存的令牌已过期,返回 401 `TOKEN_EXPIRED`(system_user 令牌默认永不过期)。

GET
/api/v1/meta/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/meta/ads-token'
响应示例
{  "success": true,  "data": {    "accessToken": "string",    "expiresAt": "2019-08-24T14:15:22Z",    "scopes": [      "string"    ],    "tokenType": "user",    "userId": "string",    "userName": "string",    "businessId": "string"  }}