帖文取得帖文
返回 Sofia

帖文

取得帖文

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

GEThttps://api.sofia-post.com/api/v1/posts/{id}
GET/v1/posts/{id}
curl -X GET 'https://api.sofia-post.com/api/v1/posts/{id}' \
  -H "Authorization: Bearer $SOFIA_API_KEY"

授權

  • Authorizationstring必填

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

路徑參數

  • idstring必填

    帖文的識別碼。

回應

200application/json

帖文及各目標的狀態。

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

    帖文預計發布的時間

401

權杖缺失、未知、已過期或已被撤銷。

403

權杖沒有 posts:read scope。

404

post_not_found：不在該 Workspace 內（測試模式下為不在授權範圍內）。

4XXapplication/json

其他任何錯誤，以錯誤結構回傳。