排期 APIAPI
一个字段，定时发布帖子
发送与立即发布相同的请求体，加上 schedule_at 时间戳，FoPost 会把它保留在队列中直到那一刻。发出前一切都可编辑，投递结果按账号报告。
POST /v1/posts
curl -X POST https://api.fopost.com/v1/posts \
-H "X-API-Key: $API_KEY" \
-H "Content-Type: application/json" \
-d '{
"workspace_id": "9b2f6c1e-...",
"status": "scheduled",
"schedule_at": "2026-09-01T09:00:00Z",
"content": [{ "text": "Webhook retries are live. Read the changelog." }],
"accounts": ["4a71d80b-...", "c30e9f12-..."]
}'一个时间戳
任何未来的 ISO 8601 时间均可。队列会接手并按时发布。
发出前均可编辑
对队列中的任何内容，PUT 修改文本、媒体、账号或时间。
按账号投递
发出后，每个账号都会报告自己的状态和永久链接。
GET /v1/posts?status=scheduled
curl "https://api.fopost.com/v1/posts?workspace_id=9b2f6c1e-...&status=scheduled" \
-H "X-API-Key: $API_KEY"
{
"data": [
{ "id": "7d3e0a52-...", "status": "scheduled", "schedule_at": "2026-09-01T09:00:00Z", "accounts": [{ "id": "4a71d80b-...", "platform": "linkedin", "publish_status": "pending" }] },
{ "id": "8e4f1b63-...", "status": "scheduled", "schedule_at": "2026-09-02T09:00:00Z", "accounts": [{ "id": "c30e9f12-...", "platform": "twitter", "publish_status": "pending" }] }
],
"meta": { "page": 1, "per_page": 30, "total": 2, "total_pages": 1 }
}按状态筛选
用一个查询参数列出草稿、定时、已发布或失败的帖子。
标签
按活动给每条帖子打标签，并按标签筛选队列。
按工作区
一个密钥只能看到一个工作区，一个客户的队列永远不会与另一个混在一起。
调整
发出前改时间、重写或取消
计划总会变。PUT 一条定时帖子，即可修改它的时间、文本、媒体或目标账号。取消后它会被标记为已取消且永不投递，也可以直接删除。在队列接手之前，什么都不会被锁定。
查看 PUT 端点PUT /v1/posts/:id
curl -X PUT https://api.fopost.com/v1/posts/7d3e0a52-... \
-H "X-API-Key: $API_KEY" \
-H "Content-Type: application/json" \
-d '{ "schedule_at": "2026-09-01T14:00:00Z" }'改期
修改 schedule_at，队列就会把帖子移到新时间。
替换内容
替换队列中帖子的 content 数组或媒体 id。
取消或删除
从队列中撤下一条帖子，不影响队列中的其他内容。
确认
无需轮询，就知道帖子何时发出
到了定时时间，帖子会按账号拆分为多个投递。注册 webhook 后，每个投递都会触发 delivery.published 或 delivery.failed；如果你偏好拉取模式，也可以轮询 deliveries 端点。
开始构建
结果确定时触发 Webhook
delivery.published 包含帖子 id、账号和永久链接。
重试
临时的网络错误会先按退避策略重试，之后才会报告失败。
发布后的数据分析
上线后，可用同一个帖子 id 从 Analytics API 读回曝光量和互动数据。
关于 排期 API 的常见问题解答
最多可以提前多久排期？
想多久都行。任何未来的 ISO 8601 时间戳都可接受，队列会保留帖子直到那一刻。
schedule_at 使用什么时区？
发送以 Z 结尾的 UTC 格式 ISO 8601 时间戳。你发送的值就是执行的值，服务器不会做任何转换。
帖子排期后还能编辑吗？
可以。对尚未发出的帖子，PUT 任意字段，包括时间。帖子发布后，编辑只作用于记录；要从网络上移除，请使用删除。
如果发布时我的服务器宕机了怎么办？
没有任何影响。队列运行在 FoPost 内部，而不是你的基础设施上，因此无论你的进程是否在运行，帖子都会照常发出。
可以只排期到部分账号吗？
可以。accounts 数组就是目标列表。只放入应该收到帖子的账号，每个账号都会有自己的投递记录。
有速率限制吗？
有，每个密钥每分钟 100 次请求。用一个脚本排好一周的帖子，完全在限制之内。