Postproxy

Postproxyとは？

Postproxyは、単一のRESTエンドポイントで複数のソーシャルネットワークに投稿できる統合ソーシャルメディアパブリッシングAPIです。プラットフォームごとの個別インテグレーションを構築・維持する代わりに、1回の接続で1つのペイロードを送信するだけ。Postproxyがコンテンツとメディアを各選択プラットフォームのルールにマッピングします。

主な目的は、接続処理、リクエストのプラットフォーム変換、各プラットフォームごとの投稿結果を含む安定したパブリッシングAPIレイヤーの提供です。

主な機能

• 統一パブリッシングエンドポイント（REST）：単一リクエスト（例: POST /v1/publish またはドキュメントの POST /api/posts）に1つのペイロードと選択「プロファイル」を指定し、Postproxyが複数プラットフォームへの投稿を処理。
• プラットフォームごとの結果マッピング：APIが各宛先プロファイルごとの結果（例: published, processing, failed）を返却し、各ネットワークの状況を確認可能。
• プラットフォーム接続管理：OAuthフロー、トークン保存、自動更新をプラットフォーム接続ワークフローの一部として処理。
• 決定論的リトライとステータス報告：リトライとレート制限/クォータ対応をサポートし、明確な投稿状態報告とログ付き試行。
• 配信のためのフォーマット変換：コンテンツを各プラットフォームの要件に変換（例: メッセージ/ボディの各ネットワーク向け適応）。
• 一般言語向けSDK：Node、Python、Ruby、その他の人気言語の公式SDKを参照し、カスタムAPI実装を削減。
• 投稿ライフサイクルイベント用のWebhook：Webhookエンドポイントを作成（例: post.processed、platform_post.published、platform_post.failed）し、Postproxyから更新を受信。

Postproxyの使い方

1. Postproxyドキュメントから始め、APIキーでAPIリクエストを作成（サイトにAuthorization: Bearer YOUR_API_KEYとJSONペイロード例あり）。
2. Postproxyのプラットフォーム接続（OAuth）で投稿先ソーシャルアカウントを接続。Postproxyがトークンと更新を管理。
3. 投稿コンテンツ＋対象プロファイル（プラットフォーム）リストとオプションのメディアURLで1リクエスト送信。
4. オプションでWebhookイベントを購読し、処理完了時やプラットフォーム投稿の成功/失敗時にアプリに通知。

サイトの例ペイロードには以下フィールド：

• post.body（一部SDK例ではcontent）
• profiles（例: "twitter"、"linkedin"、"threads"）
• media（メディアURL配列）

ユースケース

• アプリに単一「投稿」アクションを実装：製品が1つの投稿フローを提供し、Postproxyが各選択プラットフォームのフォーマット、配信、結果を処理。
• 脆弱なプラットフォーム別インテグレーションの置き換え：チームが複数カスタムインテグレーションを1回のAPI呼び出しに統合し、プラットフォーム変更の影響範囲を削減。
• エージェンシーや複数クライアント投稿キュー：プロファイルグループ化とスケジュール/キュー概念でクライアント接続を分離し、大容量投稿を管理。
• 自動化パイプラインとAIトリガー投稿：上流ワークフローの単一ステップとして投稿扱い（例: 自動化ノードやエージェントトリガー）、Postproxyがリトライとステータスを処理。
• Postproxyアカウントなしエンドユーザー向けサーバーサイド投稿：顧客ごとのスコープ環境をプロビジョンし、あなたのブランド下で投稿を実行、ユーザーはUI経由でアカウント接続。

FAQ

• 対応プラットフォームは？ サイトにInstagram、TikTok、LinkedIn、X、YouTube、Facebook、Threads、Pinterestのサポート記載。

• 1リクエストで複数ネットワークに投稿可能？ はい。例にprofilesで対象プラットフォームを指定した単一ペイロードがあり、APIが各プラットフォームにコンテンツをマッピング。

• OAuthトークン更新を手動で？ いいえ。サイトにOAuthフロー、トークン保存、自動更新を管理すると記載。

• 各プラットフォームの成功をどう確認？ Postproxyがプラットフォームごとの結果（failed、published含む）を提供し、決定論的リトライと明示的ステータス報告をサポート。

• 投稿イベント用のWebhookは？ はい。サイトにpost.processed、platform_post.published、platform_post.failedなどのイベント付きWebhook作成リクエスト例あり。

代替案

• 各公式プラットフォームAPIとの直接統合を構築：最大限の制御が可能ですが、通常、各プラットフォームごとにOAuthフロー、フォーマットルール、レート制限処理、エラー/リトライロジックを個別に維持する必要があります。
• 専用ソーシャルメディア管理プラットフォームを使用：これらのツールは独自のワークフローを通じてネットワーク間での投稿を処理します。カスタムAPI制御を速いセットアップと独自のUI/プロセスと交換します。
• 汎用オートメーション＋スケジューラーとプラットフォーム別アダプターを使用：パイプラインで投稿ステップを調整できますが、各宛先ネットワークごとにアダプター/統合コードが必要です。
• ソーシャルコネクター付きiPaaS/統合サービスを使用：ワークフローを一元化できますが、メッセージ変換、リトライポリシー、プラットフォーム別結果詳細は利用可能なコネクターと設定に依存します。