账号连接与平台
已连接的社交账号、如何引用它们,以及如何保持可用。
账号连接(connection) 是用户在 LumiPath 控制台里连接的一个社交账号。API 本身不负责连接账号,OAuth 授权在控制台完成。
获取 connectionId
curl "https://app.lumipath.cn/api/v1/connections?platform=youtube" \
-H "Authorization: Bearer $LUMI_API_KEY"每一项都有 connectionId。大多数接口把它作为参数,并根据它推断平台,所以不需要传 platform 字段。
发布接口是例外:一次请求可以发到多个平台,所以 POST /api/v1/social-posts 接收 platforms 列表和按平台分开的 id 列表,见发布指南。
connectionId 是稳定的,请保存它,而不是保存用户名。
支持的平台
可以连接 TikTok、YouTube、Instagram、Facebook(主页)、Threads、X、Pinterest 和 LinkedIn(仅公司主页)。
不是每个接口都支持所有平台,不支持的组合返回 400 UNSUPPORTED_PLATFORM,具体以各接口参考页为准。
连接失效时
| 信号 | 含义 | 处理方式 |
|---|---|---|
401 TOKEN_EXPIRED | 平台拒绝了授权。 | 请用户在控制台重新授权该账号。 |
401 ACCOUNT_UNLINKED | 没有保存授权。 | 请用户重新连接该账号。 |
连接列表里的 reauthBy | 授权需要在这个时间之前刷新。renewsOnUse: true 表示正常使用就会自动续期。 | 在到期前提醒用户。 |
health 不为 null | 平台限制了该账号(根据发布失败检测到)。 | 在此期间,发到这个连接的内容会直接失败,返回 errorCode: "ACCOUNT_UNHEALTHY",不会请求平台。用户在平台侧处理好之后,调用 POST /api/v1/connections/{id}/health/clear。 |