SyncPostly API 总览
SyncPostly API 的基础概念、版本信息与覆盖范围
快速入口
直接跳到最常用的帮助文档。
SyncPostly 的开发者 API 以 Media、Posts、Social Accounts、Post Results 为核心资源。你可以用它批量创建帖子、上传或绑定媒体、查询账号清单以及拉取发布结果。
基础信息
- 基础地址：
https://<your-app-host>/api/v1（本地开发为http://localhost:3000/api/v1）。 - 版本：
v1。 - 传输：HTTPS + JSON，统一使用 UTF-8。
典型接入流程
- 创建或轮换 API Key。
- 上传媒体，或登记外部媒体 URL。
- 创建帖子并绑定一个或多个目标社交账号。
- 轮询 post 或 post-results 接口跟踪投递状态。
- 在你的系统里持久化外部 ID，用于幂等和报表归档。
本章节包含
- 认证与 API Key 生命周期。
- 所有列表接口共享的错误与分页约定。
- 分资源的说明：Media、Posts、Social Accounts、Post Results 以及公共模型。
客户端示例
文档默认展示 curl；任意 HTTP 客户端都可直接使用（Fetch、Axios、requests 等）。
把 YOUR_SECRET_TOKEN 替换成真实密钥并放在服务器端。