帖文

編輯帖文

任何網絡開始傳送前，可替換 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>
帖文預計發布的時間

這個頁面對你有幫助嗎？