Postproxy

Postproxy 是什麼？

Postproxy 是一個統一的社群媒體發布 API，讓您使用單一 REST 端點即可發佈到多個社群網路。無需建置並維護各平台的獨立整合，您只需連接一次並發送一個 payload；Postproxy 會將您的內容和媒體對應到每個選定平台的規則。

核心目的是提供穩定的發布 API 層，包括連接處理、請求轉換至平台，以及各平台的發布結果。

主要功能

• 統一發布端點 (REST)：發送單一請求（例如 POST /v1/publish 或文件中的 POST /api/posts），包含一個 payload 和選定的「profiles」，Postproxy 會處理跨多平台的發布。
• 各平台結果對應：API 會依目的地 profile 返回結果（例如已發布、處理中、失敗），讓您了解每個網路的狀況。
• 平台連接管理：OAuth 流程、權杖儲存及自動更新均由 Postproxy 在平台連接流程中處理。
• 確定性重試與狀態回報：系統支援重試及速率限制/配額感知行為，並提供明確的發布狀態回報與記錄嘗試。
• 格式轉換以符合傳遞需求：內容會轉換以符合各平台要求（例如訊息/主體如何適應每個網路）。
• 常見語言 SDK：官方 SDK 適用於 Node、Python、Ruby 等熱門語言，減少自訂 API 管線需求。
• 發布生命週期事件的 Webhooks：您可建立 webhook 端點（例如 post.processed、platform_post.published 和 platform_post.failed 等事件），接收 Postproxy 的更新。

如何使用 Postproxy

1. 從 Postproxy 文件開始，使用您的 API 金鑰建立 API 請求（網站顯示 Authorization: Bearer YOUR_API_KEY 和 JSON payload 範例）。
2. 透過 Postproxy 的平台連接 (OAuth) 連結您想發布的社群帳戶。Postproxy 會管理權杖與更新。
3. 以單一請求發布：發送您的貼文內容，加上目標 profiles (平台) 清單及選用媒體 URL。
4. 選用：訂閱 webhook 事件，讓您的應用程式在處理完成或平台發布成功/失敗時收到通知。

網站範例 payload 包含欄位如：

• post.body（或某些 SDK 範例中的 content）
• profiles（例如 "twitter"、"linkedin"、"threads"）
• media（媒體 URL 陣列）

使用案例

• 在您的應用程式中建置單一「發布」動作：產品可提供使用者單一發布流程，而 Postproxy 處理各網路的格式化、傳遞及結果。
• 取代脆弱的各平台整合：團隊可將多個自訂整合合併為單一 API 呼叫，減少受平台變更影響的範圍。
• 代理商或多客戶發布佇列：使用 profile 分組及排程/佇列概念，保持不同客戶連接分離，並管理高量發布。
• 自動化管線及 AI 觸發貼文：將發布視為上游工作流程的單一步驟（例如由自動化節點或代理觸發），Postproxy 處理重試與狀態。
• 無 Postproxy 帳戶的終端使用者伺服器端發布：為每位客戶配置範圍環境，讓發布以您的品牌執行，使用者透過您的 UI 連結帳戶。

常見問題

• 支援哪些平台？ 網站列出支援 Instagram、TikTok、LinkedIn、X、YouTube、Facebook、Threads 和 Pinterest。

• 可以一次請求發佈到多個網路嗎？ 可以。範例顯示單一 payload 搭配 profiles 指定目標平台，API 會將內容對應至各平台。

• 我需要自行處理 OAuth 權杖更新嗎？ 不需要。網站說明 OAuth 流程、權杖儲存及自動更新均由系統管理。

• 如何知道每個平台是否成功？ Postproxy 提供各平台結果（包含失敗及已發布狀態），並支援確定性重試與明確狀態回報。

• 有發布事件的 Webhooks 嗎？ 有。網站包含 webhook 建立請求範例，事件如 post.processed、platform_post.published 和 platform_post.failed。

替代方案

• 直接建置與官方平台 API 的整合：這可提供最大控制權，但通常需要為每個平台維護獨立的 OAuth 流程、格式規則、速率限制處理，以及錯誤/重試邏輯。
• 使用專屬社群媒體管理平台：這些工具透過自家工作流程處理跨網路發布；你會以放棄自訂 API 控制，換取更快速的設定和特定 UI/流程。
• 使用通用自動化 + 排程器搭配各平台適配器：你可在管線中編排發布步驟，但仍需為每個目標網路撰寫適配器/整合程式碼。
• 使用具社群連接器的 iPaaS/整合服務：這可集中工作流程，但訊息轉換、重試政策，以及各平台結果細節取決於可用連接器與設定。