核心功能
PostQued API 是面向社交媒体运营的自动化发布平台，主要解决多平台内容分发的技术门槛问题。核心用法遵循「上传-授权-发布-监控」四步流程：先通过预签名 URL 或直传方式上传视频/图片素材；接着查询已绑定的平台账号（目前以 TikTok 为主）；随后携带幂等键发起发布请求，支持即时发送或定时调度；最后通过 publishId 轮询状态直至完成。
显著优点
- 多平台支持：以 TikTok 为核心，架构预留扩展性，统一管理不同社交账号
- 草稿优先策略：默认
intent: draft将内容推至 TikTok 创作者 inbox，人工最终确认后发布，降低误发风险 - 幂等设计：强制要求
Idempotency-Key头，24 小时内重复请求自动去重，避免重复发布 - 精细隐私控制：支持
privacyLevel分级（公开/互关/粉丝/仅自己），并可单独禁用合拍、拼接、评论功能 - 商业化合规：内置
brandContentToggle与brandOrganicToggle满足付费合作披露要求
局限与风险
- TikTok 依赖单一：当前主要功能围绕 TikTok，其他平台支持尚不明确
- 直接发布受限：
publish意图需额外 API 审批，无法完全自动化 - 速率限制较严：上传 20/分钟、发布 10/分钟，大规模运营需队列管理
- 内容审核黑箱：平台方（TikTok）的最终审核结果无法通过 API 预知，存在发布失败可能
- 密钥安全：API Key 以
pq_开头，需妥善保管，泄露可能导致账号被恶意操作
适用人群
内容创作者、MCN 机构、社交媒体运营团队、品牌方营销部门，尤其适合需批量管理多 TikTok 账号、追求发布流程标准化与定时策略的用户。
常规风险提示
务必在 .env 中管理密钥，避免硬编码；生产环境建议配合 S3 等对象存储中转大文件；定时任务需考虑时区转换与平台服务器时间差异；草稿模式虽增加人工环节，但建议保留作为内容终审机制。