跳至内容
SUNGAI / DEVELOPER GUIDE

从这里开始下一次集成。

用统一工作流连接账号、原片、草稿、审核与排期。

当前工作台是浏览器交互演示,使用示例账号和本地数据。演示凭证、分析、消息回复与发布结果均不接入真实平台。下方另附服务端 API 说明,供后续集成。

01 / 几分钟体验完整流程

  1. 打开工作台,无需注册或密码。
  2. 连接示例渠道,选择平台与显示名称,不收集 OAuth 或密码。
  3. 创建内容,选择一个或多个账号,添加内容并分别预览。
  4. 保存草稿后逐条审核,主动选择可见范围并确认。即时演示发布经过短暂模拟处理后完成。
  5. 打开日历查看排期。移动已确认的内容会清除确认,需重新审核。

02 / 体验 API 工作流

调试台对工作台同一份本地演示记录执行请求。选择预设、检查 JSON 并运行;POST /posts 会创建立即出现在发布记录中的本地草稿。

GET /accounts
GET /posts
GET /capabilities
GET /demo/analytics

POST /posts
{
  "accountId": "ACCOUNT_ID_FROM_GET_ACCOUNTS",
  "content": "Something worth sharing.",
  "requestId": "a-unique-operation-id"
}

以上为浏览器内操作,不是公共 HTTP 接口。相同 requestId 不可用于不同内容,保存草稿不等于确认发布。

试运行请求

03 / 账号与能力

可用十种平台身份体验界面。连接均为示例记录,移除操作不影响真实社交账号。数据分析、评论和消息使用示例数据。

能力演示体验
内容发布一次创建,逐个平台预览,掌握每一条发布。
定时排期使用可视化内容日历,安排未来一周或一个月。
数据分析了解曝光、互动,以及受众真正感兴趣的内容。
评论管理在同一个收件箱查看、整理并回复评论。
消息管理集中管理对话,让每一次交流都有上下文。

独立服务端实现中保留 TikTok 视频与 Bluesky 文字适配器。TikTok 仍需开发者凭证和审核,其余平台为界面演示。当前未接入生产版分析、评论或消息适配器。

04 / 你的原创素材

可上传 MP4、MOV 或 WebM 视频,时长 1–180 秒,每个文件不超过 100 MiB。原片保存在浏览器 IndexedDB,刷新后仍可预览,素材库上限 1 GiB。删除前需取消使用该文件的待处理草稿。素材不会上传到服务端。

05 / 投递前逐条核对

选择多个渠道会生成独立草稿,每条都需明确选择可见范围并由创作者确认。TikTok 演示仅提供 SELF_ONLY。修改内容或排期会清除确认,并使旧版本审核失效。

draft → processing → published (simulated)
     ↘ scheduled ↗

Edit draft / reschedule → draft → review again
Cancel draft / scheduled → cancelled

此工作台中的“已发布”仅表示模拟流程完成,并非平台回执。

06 / 管理内容日历

在编辑器或审核页选择未来日期与时间,日历使用设备本地时间。可拖动可编辑内容到未来日期,改为当天 10:00 并重新审核。模拟在页面打开时或再次打开后推进,不是后台服务端任务。

07 / 体验凭证与事件

可创建指定权限的演示凭证、查看元数据并撤销。凭证以 sg_demo_ 开头,不能用于真实请求认证。添加 HTTPS Webhook 地址可体验示例投递历史;测试仅创建模拟事件和示例 HTTP 结果,不会向该地址发送请求或重试。

08 / 独立服务端 API

仓库保留 Koa REST 实现,具备真实认证、权限凭证、私有素材、创作者审核、持久化排期和签名 Webhook;目前使用单实例加密文件存储。当前演示前端与之隔离,真实账号使用前仍需完成生产前端接入和部署。

GET    /v1/capabilities       # public runtime configuration
GET    /v1/openapi.json       # full server API contract
GET    /v1/accounts           # real server authentication required
POST   /v1/posts              # create a server draft
POST   /v1/posts/:id/approve   # authenticated creator consent
POST   /v1/posts/:id/status    # actual provider status

TikTok 需要官方 OAuth、相应权限、验证后的 HTTPS 域名及适用的 Content Posting API 审核。代码与演示不能替代审核。Bluesky 使用专用应用密码;不要将平台凭证填入此演示工作台。

阅读服务端 OpenAPI 契约 ↗

09 / 限制与存储

每个浏览器:10 个有效示例账号、10 枚有效模拟凭证、5 个 Webhook、1 GiB 素材,以及最近 100 条操作记录。请另存重要原片,在设置导出 JSON 或重置全部数据。目前没有付费收银,选择预览套餐只保存本地偏好。

打开工作区设置 →