简介

什么是 Sofia API？

Sofia API 让你的代码访问你的 Sofia 账户：你所在 Workspace 的门店、已连接的网络、媒体库、帖子和统计数据。它是基于 HTTPS 的 REST API。请求和响应都是 JSON，所有端点都在同一个基础 URL 下。

text

https://api.sofia-post.com/api/v1

API 能做什么？

发布帖子：立即发布、定时发布或存为草稿，可同时发到一个或多个网络。
发布前检查：试运行会告诉你各网络是否会接受该帖子，且不会写入任何内容。
管理媒体：上传文件，或从 URL 导入到门店的媒体库。
跟踪帖子：读取各网络的状态、永久链接或失败原因。带签名的 webhook 也能通知你。
读取统计数据：Sofia 为每个已连接账号收集的最新数据。
连接网络：创建托管链接，让所有者连接尚未连接的网络。

适合谁？

如果你是开发者，想自动化自己的 Workspace，一个个人密钥就够了：在设置 › API 中创建，并作为 Bearer 令牌发送。如果你的 SaaS 产品要代表用户在其 Workspace 中操作，请注册一个 OAuth 客户端：每个人在自己选择的 Workspace 上授权你的应用。

下一步

快速开始：一个密钥和第一次调用。
身份验证：个人密钥、带 PKCE 的 OAuth、客户端凭据。
你的第一条帖子：从媒体到发布成功。
API 参考：所有端点，附可在线试用的 Playground。