貼文取得貼文
返回 Sofia

貼文

取得貼文

回傳貼文及各網路的狀態、發布後的連結和失敗時的錯誤。正式模式可讀 Workspace 內任何貼文，測試模式讀模擬貼文。

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

取得貼文

回傳貼文及各網路的狀態、發布後的連結和失敗時的錯誤。正式模式可讀 Workspace 內任何貼文，測試模式讀模擬貼文。

授權

Authorizationstring必填

你的個人金鑰或 OAuth 存取權杖，以 Bearer <token> 傳送。

僅保存在此分頁中，且僅傳送到 api.sofia-post.com。 取得 API 金鑰

路徑參數

idstring必填

貼文的識別碼。

讀取一條貼文，以跟蹤它在每個平台上的狀態：每個目標要麼變為 published 並帶有永久連結，要麼變為 failed 並帶有原因。如果想在不輪詢 API 的情況下收到通知，請註冊一個 Webhook。

{
  "id": "efc578cc-ef79-40e9-876d-be1a33d3b8db",
  "status": "published",
  "targets": [
    {
      "platform": "instagram",
      "state": "published",
      "publishedAt": "2026-11-02T20:17:25.453Z",
      "permalink": "https://www.instagram.com/p/DfQJVPGFfb_/"
    }
  ]
}

狀態

狀態含義
draft已儲存，不會發出
scheduled將在 scheduledAt 發出
publishing正在傳送到平台
published已上線，帶有 permalink
failed平台拒絕了它；error 說明原因
sent_to_inbox已傳送到平台的應用程式中，由擁有者在那裡完成（TikTok）

貼文的 status 概括了它的各個目標。當一個平台已發布而另一個失敗時，它為 partial。

授權

  • Authorizationstringheader必填

    你的個人金鑰或 OAuth 存取權杖，以 Bearer <token> 傳送。

路徑參數

  • idstring必填

    貼文的識別碼。

回應

貼文及各目標的狀態。

  • 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>

    貼文預計發布的時間

這個頁面對你有幫助嗎？