核心用法
PostQued API Skill 是专为社交媒体自动化设计的 API 集成工具,主要服务于 TikTok 等多平台内容分发场景。其工作流程分为四步:上传内容(支持视频预签名 URL 直传与图片直接上传)→ 获取平台账号 ID → 发布内容(支持草稿/直发两种意图)→ 查询发布状态。视频上传采用分阶段确认机制,需先申请预签名 URL、上传文件至云存储、再调用完成接口确认元数据。
显著优点:
- 幂等性保障:强制要求
Idempotency-Key头,24 小时内重复请求自动去重,防止重复发布 - 精细化 TikTok 控制:支持隐私级别、互动开关(Duet/Stitch/评论)、品牌合作披露等完整参数
- 灵活调度:
dispatchAt支持 UTC 时间戳定时发布,也可即时发送 - 双模式发布:
draft模式将内容推至 TikTok 创作者收件箱人工确认,publish模式直接上线
潜在局限:
- 视频上传流程较复杂,需三次 HTTP 调用(申请 URL→上传文件→确认完成)
- 未明确说明内容审核机制,失败场景需依赖轮询状态接口排查
- 平台覆盖以 TikTok 为主,其他社交平台支持情况文档未详述
- 频率限制较严格(发布 10/分钟),大规模账号矩阵操作可能受限
适合人群:社交媒体运营团队、MCN 机构、内容创作者、SaaS 工具开发者需集成社媒发布能力者。
常规风险:
- API 密钥泄露可导致账号被盗发内容,需严格保管
pq_前缀密钥 - 幂等键重复使用或时钟漂移可能导致请求被错误拦截
- 定时任务依赖服务可用性,故障时可能错过最佳发布时间窗口