技能介绍

解决什么问题

多平台社媒发布通常需要分别对接 Twitter/X、Facebook、Instagram、TikTok、YouTube 各自的 API，处理差异化的认证、媒体规格和限流策略；排程、效果分析、A/B 测试又散落在不同 SaaS 工具里。SocialCannon 把这些收进一个 REST API，让工程师用统一接口管理内容从上传、排程、发布到数据回收的全生命周期。

核心能力与关键步骤

认证：用 Client ID / Client Secret 换取 JWT Bearer Token，有效期 1 小时，所有请求携带 Authorization: Bearer <token>。
媒体上传：三步直传 GCS（初始化 → PUT 签名 URL → 确认），支持最高 4 GB 文件，字节不经过服务端中转。
发帖：支持即时发布或 ISO 8601 排程；platformOptions.mediaType 区分 reel、story、short、community；线程和轮播走独立的 items 数组（2–25 条）。
分析：单帖指标（likes、impressions、engagementRate 等）、日期范围聚合、批量刷新（最多 50 条）。
A/B 测试（Pro）：同一测试下多个变体独立发布，按选定指标自动判定胜出；部分失败返回 HTTP 502，但测试记录仍会创建。
AI 改写：预览模式返回多平台变体供审核，发布模式一次调用完成改写与发布，自动去除 AI 写作痕迹。
统一响应格式：所有接口返回 { success, data } 或 { success, error, code }，取数据时读 response.data。

边界与注意点

当前为 封闭测试，需邮件申请，无自助注册。
TikTok 每条帖子必须传 privacyLevel，否则返回 400；brandedContent 为 true 时不可设为 SELF_ONLY。
Instagram 不支持纯文本帖，且无 API 删除能力。
媒体上传后无服务端转码或压缩，上传什么格式就发布什么格式。
LinkedIn 支持在后续版本计划中，当前不可用。