API 概览与定价

访问与价格

• Developer API 需在有效订阅基础上加购。
• 价格：$5/月 或 $50/年，在「设置 → Billing → Add-ons」购买。
• 购买后在「设置 → Developers」创建/轮换 API Key。

鉴权

• 每个请求都需携带 Authorization: Bearer <api_key>。
• Key 仅作用于当前工作区，泄露时请立即轮换。

核心接口

• POST /v1/posts：创建草稿，可附带平台特定 payload。
• POST /v1/schedule：按 scheduledAt 时间排程发布。
• GET /v1/posts：按状态过滤列表（draft、scheduled、published、 failed）。

速率限制

• 默认写入：每工作区每小时 100 次；读取更高但需分页。
• 收到 429 时查看 Retry-After，退避后再试。

Webhooks

• 配置回调接收发布状态，我们会发送 postId、platform、status 及 error（如有）。

最佳实践

• 上传前在本地校验媒体大小，避免平台拒绝。
• 重试 POST /v1/posts 时使用幂等 Key。
• 不要在前端暴露 API Key，可通过自有后端代理。