帖子

编辑帖子

任何网络开始发送前，可替换 targets、设置 scheduledAt，或在 draft 与 scheduled 之间切换，其余字段不变。

PATCHhttps://api.sofia-post.com/api/v1/posts/{id}

编辑帖子

curl -X PATCH 'https://api.sofia-post.com/api/v1/posts/{id}' \
  -H "Authorization: Bearer $SOFIA_API_KEY" \
  -H 'Content-Type: application/json' \
  -d '{"scheduledAt":"2026-11-02T10:00:00.000Z"}'

{
  "id": "string",
  "status": "published",
  "establishmentId": "string",
  "scheduledAt": "2026-11-02T10:00:00.000Z",
  "createdAt": "2026-11-02T10:00:00.000Z",
  "targets": [
    {
      "platform": "instagram",
      "accountId": "string",
      "state": "published",
      "permalink": "https://www.instagram.com/p/C1"
    }
  ]
}

编辑帖子

curl --request PATCH \
  --url 'https://api.sofia-post.com/api/v1/posts/<id>' \
  --header "Authorization: Bearer $SOFIA_API_KEY" \
  --header 'Content-Type: application/json' \
  --data '{
  "scheduledAt": "2026-11-02T10:00:00.000Z"
}'

{
  "id": "string",
  "status": "published",
  "establishmentId": "string",
  "scheduledAt": "2026-11-02T10:00:00.000Z",
  "createdAt": "2026-11-02T10:00:00.000Z",
  "targets": [
    {
      "platform": "instagram",
      "accountId": "string",
      "state": "published",
      "permalink": "https://www.instagram.com/p/C1"
    }
  ]
}

PATCH /v1/posts/{id} 会重写目标、移动 scheduledAt 或更改 status：draft 会移除时间安排但保留内容，scheduled 会重新定时。一旦某个平台已经发出了这条帖子，响应为 409 post_not_editable。

curl -X PATCH https://api.sofia-post.com/api/v1/posts/$POST_ID \
  -H "Authorization: Bearer $SOFIA_API_KEY" \
  -H 'Content-Type: application/json' \
  -d '{"status":"scheduled","scheduledAt":"2026-11-20T09:00:00Z"}'

授权

Authorizationstringheader必填
你的个人密钥或 OAuth 访问令牌，以 Bearer <token> 发送。

路径参数

idstring必填
帖子的标识符。

请求体

application/json

targetsobject[]
全部目标，整体重写（文案、媒体、格式、账号）；省略则保持不变
显示子属性
- platformstring必填
  目标网络
  允许的值： instagramfacebookxlinkedintiktok
- textstring必填
  在此网络上发布的文案
- mediaobject[]
  附加的媒体
  显示子属性
  - idstring
    门店媒体库中某个媒体的标识符（否则用 url 和 type）
  - urlstring
    媒体的公开地址（正式模式下为 https）；不提供标识符时使用
  - typestring
    按地址提供的媒体的类型
    允许的值： imagevideo
- formatstring
  格式（post、reel、story、carousel 等）；默认为该网络会采用的格式
- accountIdstring
  正式模式：负责发布的已连接账号，在门店于该网络有多个账号时使用（GET /v1/establishments/:id/accounts）
scheduledAtstring<date-time>
新的未来时间：帖子将在此时间排期发布
statusstring
draft：退回草稿（保留内容，丢失时间）；scheduled：按 scheduledAt 排期，或按原来的时间
允许的值： draftscheduled

响应

编辑后的帖子。

idstring必填
帖子的标识符
statusstring必填
跨所有网络的状态；partial：在一个网络发布成功，在另一个失败
允许的值： draftscheduledpublishingpublishedsent_to_inboxfailedpartial
establishmentIdstring必填
帖子所属的门店
createdAtstring<date-time>必填
帖子的创建时间
targetsobject[]必填
每个网络和账号一条：同一网络上的两个账号对应两条
显示子属性
- platformstring必填
  目标所在的网络
- accountIdstring必填
  负责发布的账号（GET /v1/establishments/:id/accounts）
- statestring必填
  目标在其网络上的状态
  允许的值： draftscheduledpublishingpublishedsent_to_inboxfailed
- publishedAtstring<date-time>
  目标发布的时间
- permalinkstring
  指向网络上已发布帖子的链接
- errorstring
  网络拒绝的原因
scheduledAtstring<date-time>
帖子计划发布的时间

这个页面对你有帮助吗？