跳到正文
LumiPath API

账号连接与平台

已连接的社交账号、如何引用它们,以及如何保持可用。

账号连接(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。

本页目录