登入開始免費試用
easyCoexistence 官方 API

如何在 API 上建立社交媒體排程器:佇列、媒體與貼文狀態

要在 easyCoexistence 的 Partner API 上建立社交媒體排程器,你的後端需將每則貼文連同文字、媒體,以及距今 1 分鐘至 90 日內的 publish_at,發送至 POST /channels/:id/posts。easyCoexistence 會即時複製媒體,並於指定時間將貼文發佈至 Instagram、Facebook、TikTok 或 LinkedIn,每個步驟均以狀態回報,並透過 post.published 與 post.failed 事件通知。

90 days

貼文 API 在 Instagram、Facebook、TikTok 與 LinkedIn 上可提前排程的時限;最早可排在 1 分鐘後。

30 MB and 1 GB

排程時 easyCoexistence 所複製的最大圖片與最大影片;超出此大小的檔案於當下即被拒絕。

5 min, 30 min, 2 h

網絡限流時,貼文會重試,之後才標記為失敗。

100 posts

Instagram 帳戶在任意滾動 24 小時內可發佈的 API 貼文數量;輪播視為一則。

15 a day

TikTok 透過其發佈端點對每個帳戶影片貼文的上限,且每分鐘最多六則。

排程器需要 API 提供什麼?

五項所需功能:上傳檔案的途徑、為單一帳戶排入貼文的呼叫、按時發佈的佇列、修改排程的方法,以及事件的通知。貼文 API 在同一組 ec_live_ 金鑰上提供全部功能,該金鑰同時用於連接你的客戶,因此行事曆、審批流程與編輯介面都留在你的產品內。

1UploadPOST /media, or a public HTTPS link
2SchedulePOST /channels/:id/posts with publish_at
3HoldMedia copied, the post waits in the queue
4PublishThe network's official API, at the set time
5ReportStatus on GET /posts; post.published or post.failed

如何排程一則貼文?

每個帳戶須以一個 POST 請求發送至 https://easycoexistence.com/api/v1/channels/:id/posts,其中 :id 為客戶連接工作階段中的 channel_id。publish_at 採用附有 Z 或時差的 ISO 8601 格式;若不填則立即發佈。回應為 201 並附上貼文,若即時發佈失敗則回傳 422。系統會接受 Idempotency-Key 標頭,因此逾時後重複的請求不會重複排入貼文。請求內容包括:

  • text:文字(說明、訊息或評論);media:{url, type} 或 {media_id} 的清單。
  • link:Facebook 連結貼文或 LinkedIn 文章,LinkedIn 須附標題。
  • ig_type:IMAGE、CAROUSEL、REELS 或 STORIES,若不填則從媒體推斷。
  • title 與 disable_comment 用於 TikTok 相片貼文;image_alt 用於 LinkedIn 圖片。
Schedule an Instagram carousel
curl -X POST https://easycoexistence.com/api/v1/channels/$CHANNEL_ID/posts \
  -H "Authorization: Bearer $EC_API_KEY" \
  -H "Idempotency-Key: campaign-311-ig" \
  -H "Content-Type: application/json" \
  -d '{
    "text": "Three looks for the weekend",
    "media": [
      { "url": "https://cdn.example.com/looks/1.jpg", "type": "image" },
      { "url": "https://cdn.example.com/looks/2.jpg", "type": "image" }
    ],
    "ig_type": "CAROUSEL",
    "publish_at": "2026-11-20T09:00:00-05:00"
  }'

排程器如何處理媒體?

可透過連結或上傳兩種方式。公開的 HTTPS 連結直接放入 media;用戶上傳的檔案則以請求內容加上 Content-Type 與 Content-Length 的形式發送至 POST /media,或以 {"url"} 的形式提交,再將回傳的 media_id 放入貼文。排程時,easyCoexistence 會複製檔案,因此連結只需在該時刻有效。若排程時所提供的是網頁而非檔案、出現 404、類型錯誤,或圖片超過 30 MB、影片超過 1 GB,系統會當場拒絕,而不是等到發佈當天。

每個網絡的貼文可包含什麼?

佇列在接受每則貼文前,會檢查其是否符合各網絡的規則;違反規則的貼文會被拒絕,並附上說明該規則的訊息,因此你的編輯介面可於用戶仍在編輯時顯示問題。各網絡的限制如下:

InstagramOne JPEG, a carousel of 2 to 10 items, a Reel or a Story; up to 2,200 characters; no link.
FacebookText, a link, one image or one video on a Page, never a link and a file together.
TikTokOne video, or 1 to 35 JPEG or WebP images with a title of up to 90 characters.
LinkedInText of up to 3,000 characters with one image or a titled link; no video.

貼文會經歷哪些狀態?

共六種,可透過 GET /posts/:id 與 GET /posts 查詢,並附上 publish_at、貼文上線後的連結,以及失敗時網絡回傳的錯誤。

  • scheduled:已排入佇列,等待發佈時間。
  • publishing:已交予網絡。
  • processing:網絡仍在處理,例如 TikTok 影片或 Instagram 容器。
  • published:已上線,附有連結。
  • failed:被拒絕或未獲確認;may_be_published 標示網絡可能已收到的貼文。
  • canceled:發佈前已被移除,由你操作,或因其帳戶被移除或暫停。

如何編輯、取消或重試貼文?

PATCH /posts/:id 可更改已排程貼文的時間或文字,以及 TikTok 相片貼文的標題;若要更改媒體,請取消後重新排程。DELETE /posts/:id 用於取消。POST /posts/:id/retry 會立即重新發佈失敗的貼文。若網絡已限流,貼文會在 5 分鐘、30 分鐘及 2 小時後自動重試;而標記為 may_be_published 的貼文,在重試前須先檢查帳戶。

排程器如何得知發生了什麼事?

透過事件及列表。在 Profile、Developers 下設定的狀態事件 URL 會接收 post.published 與 post.failed,並如同其他事件一樣附上 X-EC-Signature 簽名,內含貼文及其頻道,讓你的行事曆可將每則貼文標示為已上線或加以標記。GET /posts 接受 status、from、to 與 limit 參數,供行事曆檢視使用;GET /channels/:id/posts 則列出單一帳戶的貼文。若貼文在背景失敗,帳戶擁有人亦會收到電郵,每個頻道每 3 小時最多一封。

LinkedIn 貼文如何配合排程器?

需由真人逐則審批。LinkedIn 的 API 條款限制以 API 自動發佈,因此排程器須將每則 LinkedIn 貼文保留為你產品中的草稿,直至獲指定人員批准,才連同其 publish_at 發送。定期規則、資訊流與大量匯入應針對其他網絡,LinkedIn 只限已由人員審閱的貼文。

常見錯誤

  • 發送不含時差的 publish_at。沒有 Z 或時差的本地時間會被拒絕,因此應發送 2026-11-20T09:00:00-05:00,而非用戶所選的純時鐘時間。
  • 立即重試標記為 may_be_published 的貼文。網絡可能已顯示該貼文,因此應先檢查帳戶,否則貼文會發佈兩次。
  • 重複發送逾時的 POST 卻不附 Idempotency-Key。為每則貼文設定獨立的金鑰,重複請求便會返回已排入佇列的貼文,而非再排一份。
  • 為 Instagram 連結 PNG 檔案。Instagram 的發佈 API 只接受 JPEG,排程時即被拒絕,因此應在上傳步驟中轉換圖片。
使用 EasyCoexistence 完成這項設定

easyCoexistence 為你的排程器提供一個佇列,涵蓋客戶的 Instagram、Facebook、TikTok 與 LinkedIn 帳戶,以及更多頻道,全部透過各網絡的官方 API:排程時複製媒體、六種狀態、網絡限流時重試,並提供附簽名的貼文事件,每個連接 24/7 受監控。每個連接每月由 US$ 9 降至 US$ 0.75,連接越多費用越低,首 3 天免費試用。

常見問題

單一請求可否在多個網絡排程貼文?

每個請求只針對一個頻道,因此須為每個帳戶各發送一個請求,並各自附上 Idempotency-Key,同時按各網絡的限制調整文字。

貼文 API 可否排程 YouTube 影片?

YouTube 本身支援排程。透過 YouTube API 以私人模式上傳影片,並設定 publishAt,使用來自 GET /channels/:id?credentials=1 的存取權杖;YouTube 會於該時間將影片公開。

用戶可否在 easyCoexistence 的控制台中看到已排程的貼文?

Posts 頁面屬於你的帳戶,因此你的團隊可在此查看「Needs attention」、「Coming up」與「Published」,並可執行 Cancel、Retry 及 Dismiss。你的用戶則看到你的產品根據 GET /posts 所建立的行事曆。

easyCoexistence 的社交媒體排程器收費多少?

每個已連接帳戶每月由 US$ 9 降至 US$ 0.75,用戶連接越多費用越低,包括排程功能,並提供首 3 天免費試用。

繼續閱讀

兩分鐘內連接您的第一個頻道。

無需等待平台審核。連接 WhatsApp、Instagram、TikTok 或其他頻道,然後請您的 AI 發佈貼文、回覆訊息或匯報數據,並看着它運作。

  • 免費試用 3 天
  • 隨時取消
  • 只用官方 API
  • 24/7 監察

驗證日期