Social Accounts 接口

已连接账号是创建帖子时 social_accounts 字段的取值。接口只返回当前工作区的 active 状态账号。

接口列表

• GET /api/v1/social-accounts — 支持平台与用户名筛选的列表。
• GET /api/v1/social-accounts/{id} — 获取单个账号。

GET /api/v1/social-accounts

查询参数：

• offset, limit — 见分页规则。
• platform — 平台 ID 数组（twitter-x、instagram、linkedin、facebook-page、tiktok、youtube、bluesky、threads、pinterest）。
• username — 数组，执行不区分大小写的模糊匹配。

响应：

{
  "data": [
    {
      "id": "acc-123",
      "platform": "linkedin",
      "username": "syncpostly",
      "display_name": "SyncPostly Marketing"
    }
  ],
  "meta": { "offset": 0, "limit": 10, "total": 3 }
}

示例：

curl "https://<host>/api/v1/social-accounts?platform=linkedin&username=social" \
  -H "Authorization: Bearer YOUR_SECRET_TOKEN"

GET /api/v1/social-accounts/{id}

路径参数：id。返回单个账号对象；不存在或不属于当前工作区则 404。

备注

• 仅 active 账号会出现在结果中；暂停或授权失效的账号会被隐藏。
• 可直接把返回的 id 列表用于 Posts 接口，无需额外的跨平台 ID 映射。