如何基于 API 构建社交媒体排期工具:队列、媒体与帖子状态
要基于 easyCoexistence 的 Partner API 构建社交媒体排期工具,您的后端需将每条帖子的文本、媒体以及 1 分钟至 90 天后的 publish_at,发送至 POST /channels/:id/posts。easyCoexistence 会立即复制媒体,并在设定时间于 Instagram、Facebook、TikTok 或 LinkedIn 上发布该帖子,每个步骤以状态形式反馈,并通过 post.published 和 post.failed 事件推送。
posts API 在 Instagram、Facebook、TikTok 与 LinkedIn 上可提前排期的最长时间;最早可设为 1 分钟后。
排期时 easyCoexistence 可复制的最大图片与最大视频;超过此大小的文件会在当时被拒绝。
帖子遭网络限流后,在被标记为失败前会再次尝试。
Instagram 账户在滚动的 24 小时内可通过 API 发布的帖子数;轮播计为一条。
TikTok 通过其发布端点对每个账户的视频帖子设定的上限,每分钟最多六条。
排期工具需要 API 提供哪些功能?
五项:一个上传文件的位置、一个为某个账户排队帖子的调用、一个按时发布的队列、一种修改排期的方式,以及对结果的通知。帖子 API 通过用于连接您客户的同一个 ec_live_ 密钥提供这五项功能,因此日历、审批流程和编辑器都保留在您的产品中。
如何排期一条帖子?
对每个账户发送一次 POST,地址为 https://easycoexistence.com/api/v1/channels/:id/posts,其中 :id 为客户连接会话中的 channel_id。publish_at 采用带 Z 或时差偏移的 ISO 8601 格式;若省略则立即发布。成功时返回 201 及帖子信息;若立即发布的帖子失败,则返回 422。系统支持 Idempotency-Key 请求头,因此超时后重复的请求不会将帖子重复排入队列。请求体包含以下字段:
- text:正文、消息或评论内容;media:由 {url, type} 或 {
media_id} 组成的列表。 - link:Facebook 链接帖子或 LinkedIn 文章;LinkedIn 需附带标题。
ig_type:IMAGE、CAROUSEL、REELS 或 STORIES,省略时根据媒体自动推断。- title 与
disable_comment用于 TikTok 图文帖子;image_alt用于 LinkedIn 图片。
curl -X POST https://easycoexistence.com/api/v1/channels/$CHANNEL_ID/posts \
-H "Authorization: Bearer $EC_API_KEY" \
-H "Idempotency-Key: campaign-311-ig" \
-H "Content-Type: application/json" \
-d '{
"text": "Three looks for the weekend",
"media": [
{ "url": "https://cdn.example.com/looks/1.jpg", "type": "image" },
{ "url": "https://cdn.example.com/looks/2.jpg", "type": "image" }
],
"ig_type": "CAROUSEL",
"publish_at": "2026-11-20T09:00:00-05:00"
}'排期工具如何处理媒体?
可通过链接或上传。公开的 HTTPS 链接直接放入 media;用户上传的文件需发送至 POST /media,可将文件作为请求体(附带 Content-Type 与 Content-Length),也可使用 {"url"},随后将返回的 media_id 放入帖子中。排期时 easyCoexistence 会复制文件,因此您的链接只需在该时刻有效。若提供的是网页而非文件、返回 404、类型错误,或图片超过 30 MB、视频超过 1 GB,则会在排期时被拒绝,而非在帖子发布当天。
每个网络的帖子可以包含哪些内容?
队列在接受帖子前会依据各网络的规则进行检查。违反规则的帖子会被拒绝,并附上说明该规则的消息,因此您的编辑器可在用户编辑时即时显示问题。各网络的要求如下:
帖子会经过哪些状态?
共六种,可通过 GET /posts/:id 与 GET /posts 查询,同时返回 publish_at、帖子上线后的链接,以及发布失败时网络返回的错误:
- scheduled:在队列中,等待发布时间。
- publishing:已交给网络处理。
- processing:网络仍在处理,例如 TikTok 视频或 Instagram 容器。
- published:已上线,附带链接。
- failed:被拒绝或未获确认;
may_be_published标记网络可能已接收的帖子。 - canceled:发布前被移除,可能是您取消,也可能是其所属频道被删除或暂停。
如何编辑、取消或重试帖子?
PATCH /posts/:id 可更改已排期帖子的时间或文本,以及 TikTok 图文帖子的标题;若要更换媒体,请取消后重新排期。DELETE /posts/:id 用于取消帖子。POST /posts/:id/retry 会立即重新发布失败的帖子。因网络限流而失败的帖子,将在 5 分钟、30 分钟和 2 小时后自动重试;标记为 may_be_published 的帖子,则需先检查账户,再进行任何重试。
排期工具如何获知发生了什么?
通过事件与列表获知。在“个人资料”的“开发者”下设置的事件 URL 会接收 post.published 和 post.failed 事件,与其他事件一样使用 X-EC-Signature 签名,并包含帖子及其频道信息,使您的日历能够将每条帖子标记为已上线或予以提示。GET /posts 支持 status、from、to 与 limit 参数,用于日历视图;GET /channels/:id/posts 则列出单个账户的帖子。后台失败的帖子会向账户所有者发送邮件,每个频道每 3 小时最多一封。
LinkedIn 帖子如何适配排期工具?
需由人工逐条审批。LinkedIn 的 API 条款限制使用其 API 实现自动发帖,因此排期工具会将每条 LinkedIn 帖子保留为您产品中的草稿,直至指定人员批准,然后连同其 publish_at 发送。周期性规则、信息流与批量导入应面向其他网络,LinkedIn 仅用于已由人工审核的帖子。
常见错误
- 发送不带时差偏移的 publish_at。没有 Z 或时差偏移的本地时间会被拒绝,因此请发送 2026-11-20T09:00:00-05:00,而不是用户选择的裸时钟时间。
- 立即重试标记为 may_be_published 的帖子。网络可能已显示该帖子,因此请先检查账户,否则帖子会发布两次。
- 超时的 POST 未附带 Idempotency-Key 便重复发送。请为每条帖子分配独立的密钥,使重复请求返回已排队的帖子,而非再排一份副本。
- 为 Instagram 使用 PNG 文件链接。Instagram 的发布 API 仅接受 JPEG,排期时会拒绝该帖子,因此请在上传步骤中转换图片格式。
easyCoexistence 为您的排期工具提供统一队列,可管理客户的 Instagram、Facebook、TikTok 和 LinkedIn 账户及更多频道,所有连接均通过各网络的官方 API 实现:排期时复制媒体、六种状态、针对限流的重试与带签名的帖子事件,且每个连接全天候 24/7 监控。每个连接每月 US$ 9 至 US$ 0.75,连接越多单价越低,前 3 天免费试用。
常见问题
一个请求能否同时在多个网络排期帖子?
每个请求只针对一个频道,因此请为每个账户各发送一次,各自使用独立的 Idempotency-Key,并使文本符合各网络的限制。
帖子 API 能否排期 YouTube 视频?
YouTube 原生支持排期。请通过 YouTube API 以 private 状态上传视频,并设置 publishAt,使用 GET /channels/:id?credentials=1 返回的访问令牌,YouTube 会在该时间将视频公开。
用户能否在 easyCoexistence 的控制台中看到已排期的帖子?
“帖子”页面属于您的账户,因此您的团队可在此查看“需要处理”“即将发布”和“已发布”,并可执行“取消”“重试”和“忽略”。您的用户则通过您的产品根据 GET /posts 构建的日历查看帖子。
easyCoexistence 的社交媒体排期功能费用是多少?
每个已连接账户每月 US$ 9 至 US$ 0.75,随连接数增加而降低,包含排期功能,前 3 天免费试用。
继续阅读
两分钟连接您的第一个渠道。
无需等待平台审核。连接 WhatsApp、Instagram、TikTok 或其他渠道,然后让您的 AI 发布、回复或生成报告,看它如何运作。
- 免费试用 3 天
- 随时取消
- 仅使用官方 API
- 全天候 24/7 监控
验证时间