独立发帖与排期服务

以客户信息表的 customerId 为唯一业务归属,使用独立素材服务中的素材与不可变版本。

实际发布:已启用

接入流程

  1. 宿主系统验证用户的客户访问权限,并从服务端调用本服务。
  2. GET /v1/customers/{customerId}/capabilities 获取该客户绑定及可用性。
  3. 从素材服务选择素材,将 assetId + versionId 和文案提交至 /posts;批量使用 /posts/batch。
  4. GET /posts 查询日历和草稿;PUT /posts/{id} 保存完整编辑。
  5. POST /posts/{id}/cancel 取消;DELETE 删除未发布任务。修改必须提供 If-Match: revision。

接口约定

服务端 Bearer 密钥带客户及操作范围;按用户调用还支持短期签名授权。创建请求必须携带 Idempotency-Key,重复请求不会重复排期。

草稿允许内容未填写。排期使用带时区偏移的 ISO 时间,保存为 UTC,同时保存 IANA 时区用于显示。批量一次最多 20 条。

支持单次、每日、每周及每月排期;FB/IG 按账号能力每帖最多三张图片或一个视频。GBP 不接收视频,多图计划明确选择后仅发布封面。宿主通过兼容接口接入,任务记录、执行与回执统一由本服务管理。

执行状态

草稿 → 已排期 → 执行中 → 待平台确认/已发布/部分成功/失败/待核对。平台超时或进程中断不会自动重发。