REST API
BulkPublish
用 REST API 定时发布社交媒体内容
应用自己用的那套 API,同样开放给你。通过普通的 HTTP 和 JSON,用任何语言都能创建和排期内容、上传媒体、管理渠道、读取数据分析。
适合要把发布能力做进自家产品、内部工具或数据管道的团队,尤其是连多加一个库都不想的时候。
REST API 设置
创建一个 API 密钥,作为 Bearer 令牌发送,然后从交互式参考文档开始。在写第一行代码之前,每个请求都能先在浏览器里试一试。
- 注册一个 BulkPublish 账号,并连接你要发布的渠道。
- 打开设置,再打开开发者,创建一个 API 密钥。每个密钥只属于一个组织,撤销它不会影响其他部分。
- 每次请求都用 bearer token 带上这个密钥。参考文档为每个操作都给了完整示例。
REST API 的操作
REST API 可以使用 116 个操作,下面按 19 个类别列出。这份清单直接读取自 REST API 所调用的代码,所以上面的每一项现在都能用。
| 范围 | 操作 |
|---|---|
| 数据分析 | Account-level analytics,Engagement metrics,Per-post metric history,Summary stats,Tracked-link performance,Trigger metrics sync |
| API 密钥 | API usage history,API usage stats,Create API key,Delete API key,List API keys |
| 日历备注 | Create calendar note,Delete calendar note,List calendar notes,Update calendar note |
| 渠道组 | Create channel set,Delete channel set,List channel sets,Update channel set |
| 渠道 | Check channel health,Disconnect channel,Get channel,Get platform-specific options for a channel,List channels,List platforms and their availability,Search users for @mention,Update channel settings |
| 客户端连接链接 | Create a client connect link,List client connect links,Revoke a client connect link |
| 话题标签组 | Create hashtag group,Delete hashtag group,Get hashtag group,List hashtag groups,Update hashtag group |
| 收件箱 | Get a conversation's messages,Like, hide or delete a comment on a published post,List conversations,Reply in a conversation,Reply to a comment on a published post,Update a conversation (read, archive, snooze, assign) |
| 标签 | Create label,Delete label,List labels,Update label |
| 媒体 | Abort multipart upload,Complete multipart upload,Delete media file,Finalize a direct upload,Get a direct upload URL,Get media file,Get media labels,Get media thumbnail,List media files,Set alt text,Set media labels,Start multipart upload (large videos, up to 1GB),Upload media (single request) |
| 通知 | Delete notifications,Get notification preferences,List notifications,Mark as read,Register a mobile push token,Unregister a mobile push token,Update preferences |
| OAuth | Exchange an authorization code or refresh token,Revoke a token |
| 组织 | Create organization,Delete organization,Get organization details,Leave an organization,List organizations,Rename organization,Switch active organization |
| 内容 | Approve a pending post,Attach or detach a post's recurring schedule,Bulk actions,Create or get the post's review link,Create post,Delete post,Get next available queue slot,Get post,Get post engagement (commenters + reactors),Get post metrics,List posts,Publish as Story,Publish immediately,Reject a pending post,Retry failed platforms,Revoke the post's review link,Update post |
| 审核链接 | Create a client review link for a batch of posts,List client review links,Revoke a client review link |
| RSS 自动发布 | Add RSS feed,Delete RSS feed,List RSS feeds,Update RSS feed |
| 周期计划 | Create schedule,Delete schedule,Get schedule,List recurring schedules,Update schedule |
| 模板 | Create post template,Delete post template,Get post template,List post templates,Update post template |
| 实用接口 | Activity log,Add extra channel slots,Create AI credits checkout,Create X credits checkout,Generate an AI caption,Get quota usage,Preview link metadata,X (Twitter) API spend |
内容会发到哪里
REST API 安排的内容可以发到下面这 15 个网络中的任意一个,可以只发一个账号,也可以所有账号一起发。点进每个网络,可以看到它的限制和内容类型。
细节
关于 REST API 的实用信息都在这里,现在设置或以后查阅都方便。
| 项目 | 内容 |
|---|---|
| 认证方式 | API 密钥,在设置里的开发者页面创建 |
| 操作数 | 116 个操作 |
| 平台数 | 15 个平台 |
常见问题
连接 REST API 之前,大家通常想知道这些。
写代码之前能先试一下请求吗?
能。交互式参考文档让你直接在浏览器中发送每个请求,所以在写下一行代码之前就能看到真实的响应。
哪些编程语言可以调用这个 API?
任何能发送 JSON 格式 HTTP 请求的语言都可以。如果你用 Node 或 Python,SDK 已经为你封装好了同一个 API。
它能覆盖 BulkPublish 的哪些部分?
上面表里的 116 个操作。内容、媒体、标签、渠道组、周期计划、RSS 自动发布和数据分析都在内,也就是应用自己会调用的全部。
认证是怎么做的?
用 API 密钥,以 bearer token 发送。在设置里的开发者页面创建。每个密钥属于一个组织,可以单独撤销,不影响其他密钥。
可以上传图片和视频吗?
可以。小文件一次请求上传,大视频则取一个直传地址,分片直接送到存储。两种方式都会返回一个媒体 id,附到内容上即可。
还没解决?帮助中心提供了详细的分步说明。
指南与教程
我们博客中使用 REST API 的教程。
其他集成
BulkPublish 还能和另外 5 个工具配合使用。选一个看看它怎么连接。