social_account_id、本地帖子 ID 和评论 ID。调用前先确认当前应用拥有目标社媒账号的访问权限。
资源关系
注意social_post_id、第三方平台帖子 ID 与action_sn不是同一个值。帖子详情和评论接口的post_id应传发帖响应中的本地social_post_id。
推荐调用顺序
准备已授权账号
通过控制台或账号授权流程得到social_account_id。账号授权接口当前返回动作流水号；在授权跳转地址和回调结果合同完整前，不要根据未声明字段自行拼接跳转。
确认频道
对需要频道的社媒平台，先刷新频道列表，再使用socialAccountSetChannel 选择频道。平台不需要频道时无需调用。
发布帖子
按目标平台选择专用发布接口。素材 URL 必须能被平台服务访问；post_date 必须是带时区的 ISO 8601 时间。
查询帖子
保存发帖响应中的social_post_id，传给 socialPostDetail 的 post_id。状态进入 published、failed 或 deleted 后停止轮询。
处理评论
使用同一个本地post_id 创建、列出或同步评论。创建评论后保存 comment_id，查询直到进入终态。
帖子状态
评论状态
评论资源可能返回processing、published、failed、deleted。查询到 published、failed 或 deleted 后停止轮询。
通过 Webhook 跟踪状态
配置回调地址后，平台会通知账号授权、重连、离线、更新与删除，以及帖子发布、失败、删除和评论发布、删除、同步终态。接收端应使用event_type 分发业务，并用 subject_id、data 中的本地资源 ID 关联现有记录。
完整事件清单和字段说明见Webhook 事件目录，验签与重试规则见配置与接收 Webhook。
素材与时间要求
media_urls中的地址必须是可公开访问的 HTTP 或 HTTPS URL，不能使用本地地址、内网地址或需要 Cookie 的下载链接。post_date示例：2026-09-01T10:00:00+08:00。不要提交没有时区的本地时间。- 各平台的内容类型和专属参数不同，请以对应平台发布接口的参数表为准。
- 创建请求超时且结果不确定时，先查询帖子列表或详情，避免直接重复发布。