如何在 API 上建立社交媒體排程器:佇列、媒體與貼文狀態
要在 easyCoexistence 的 Partner API 上建立社交媒體排程器,你的後端需將每則貼文連同文字、媒體,以及距今 1 分鐘至 90 日內的 publish_at,發送至 POST /channels/:id/posts。easyCoexistence 會即時複製媒體,並於指定時間將貼文發佈至 Instagram、Facebook、TikTok 或 LinkedIn,每個步驟均以狀態回報,並透過 post.published 與 post.failed 事件通知。
貼文 API 在 Instagram、Facebook、TikTok 與 LinkedIn 上可提前排程的時限;最早可排在 1 分鐘後。
排程時 easyCoexistence 所複製的最大圖片與最大影片;超出此大小的檔案於當下即被拒絕。
網絡限流時,貼文會重試,之後才標記為失敗。
Instagram 帳戶在任意滾動 24 小時內可發佈的 API 貼文數量;輪播視為一則。
TikTok 透過其發佈端點對每個帳戶影片貼文的上限,且每分鐘最多六則。
排程器需要 API 提供什麼?
五項所需功能:上傳檔案的途徑、為單一帳戶排入貼文的呼叫、按時發佈的佇列、修改排程的方法,以及事件的通知。貼文 API 在同一組 ec_live_ 金鑰上提供全部功能,該金鑰同時用於連接你的客戶,因此行事曆、審批流程與編輯介面都留在你的產品內。
如何排程一則貼文?
每個帳戶須以一個 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 圖片。
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,系統會當場拒絕,而不是等到發佈當天。
每個網絡的貼文可包含什麼?
佇列在接受每則貼文前,會檢查其是否符合各網絡的規則;違反規則的貼文會被拒絕,並附上說明該規則的訊息,因此你的編輯介面可於用戶仍在編輯時顯示問題。各網絡的限制如下:
貼文會經歷哪些狀態?
共六種,可透過 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 為你的排程器提供一個佇列,涵蓋客戶的 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 監察
驗證日期