帖文列出帖文
返回 Sofia

帖文

列出帖文

由新到舊列出權杖可存取門市的帖文，可按門市、狀態、日期範圍和作者篩選，分頁回傳，並用游標取得下一頁，每頁最多 100 筆。

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

授權

  • Authorizationstring必填

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

查詢參數

  • establishmentIdstring

    僅限此門市的帖文。

  • cursorstring

    上一頁回傳的 nextCursor。

  • statusstring

    正式模式：至少有一個網絡處於該狀態。帖文的 status 是各網絡的彙總，因此按 failed 篩選可能回傳 partial。

    允許的值： draftscheduledpublishingpublishedsent_to_inboxfailed

  • fromstring<date-time>

    正式模式：至少有一個網絡從此時起已發布（發布前則為已排程）。

  • tostring<date-time>

    正式模式：並且早於此時（不含）。

  • createdBystring

    正式模式：me 為權杖所代表用戶的帖文，app 為此應用建立的帖文。省略則為全部。

    允許的值： meapp

  • limitnumber

    每頁數量，1 到 100（預設 20）。

回應

200application/json

一頁帖文；還有更多時包含 nextCursor。

  • dataobject[]必填

    本頁的帖文

    顯示子屬性
    • 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>

      帖文預計發布的時間

  • nextCursorstring

    作為 ?cursor= 傳入以取得下一頁；到末尾時不再出現

400

invalid_cursor，或參數格式錯誤時的 invalid_request。

401

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

403

權杖沒有 posts:read scope。

404

establishment_not_found：權杖無法存取該門市。

4XXapplication/json

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