1回のPOSTで、すべての場所に投稿
投稿を一度作成し、届けるアカウントを指定するだけ。ネットワークごとの整形、メディアのアップロード、配信はFoPostが行います。スコープ付きキー、冪等なリクエスト、ポーリングまたはWebhookで受け取れる配信ステータスを備えています。
curl -X POST https://api.fopost.com/v1/posts \
-H "X-API-Key: $API_KEY" \
-H "Content-Type: application/json" \
-d '{
"workspace_id": "9b2f6c1e-...",
"content": [{ "text": "Shipped a new release today." }],
"accounts": ["4a71d80b-...", "c30e9f12-..."]
}'
curl -X POST https://api.fopost.com/v1/posts/7d3e0a52-.../publish \
-H "X-API-Key: $API_KEY"どのネットワークも同じ形式
同じリクエストボディで、X、LinkedIn、Instagramなど接続済みのすべてのアカウントに投稿できます。
スコープ付きキー
publishスコープを持つキーは投稿だけができます。ほかのキーに影響を与えずに無効化できます。
アカウントごとの配信
公開されると、各アカウントがステータス、外部ID、パーマリンクを個別に返します。
投稿は一度書くだけ。届け先は自由に選べます
テキスト、メディア、届けるアカウントを渡すだけ。FoPostが各ネットワークの制限とルールを適用し、プラットフォームが求める形式でメディアをアップロードして、追跡できる投稿IDを返します。スレッド、カルーセル、長文の本文も、すべて同じcontent配列で扱えます。
投稿リファレンスを読む{
"post_status": "publishing",
"deliveries": [
{ "id": "a3c5e7f9-...", "account_id": "4a71d80b-...", "status": "queued", "external_url": null, "posted_at": null, "attempts": 0 },
{ "id": "b4d6f8a0-...", "account_id": "c30e9f12-...", "status": "queued", "external_url": null, "posted_at": null, "attempts": 0 }
],
"health_warnings": []
}コンテンツブロック
順番に並べたブロックが、ネットワークに応じてスレッド、カルーセル、本文になります。
メディアは参照で指定
メディアライブラリに一度アップロードすれば、IDでいくつの投稿にも添付できます。
冪等性
冪等キーを送れば、リクエストを再試行しても二重投稿になりません。
すべての投稿の行き先を正確に把握
1つの投稿は、アカウントごとの配信に分かれます。deliveriesエンドポイントをポーリングするかWebhookを登録すれば、プラットフォームのステータス、外部ID、パーマリンク、そしてネットワークに拒否されたときのエラー内容を受け取れます。
Webhookイベントを見る
deliveriesエンドポイント
GET /v1/posts/:id/deliveriesで、すべてのアカウントとそれぞれのステータスを一覧できます。
Webhookイベント
配信が確定した瞬間に、delivery.publishedとdelivery.failedが発行されます。
再試行を標準搭載
プラットフォームの一時的なエラーは、失敗として扱う前にバックオフ付きで再試行します。
編集、キャンセル、削除もコードから
ライフサイクル全体をAPIで扱えます。予約投稿を公開前に更新したり、キャンセルしたり、公開済みの投稿をネットワークから削除したりできます。複数のブランドを運用する場合も、ラベルとワークスペースでクライアントごとの作業を分けられます。
開発を始めるcurl -X PUT https://api.fopost.com/v1/posts/7d3e0a52-... \
-H "X-API-Key: $API_KEY" \
-H "Content-Type: application/json" \
-d '{ "content": [{ "text": "Updated copy." }] }'公開前に編集
キューに残っている投稿なら、テキスト、メディア、アカウントを変更できます。
ラベル
キャンペーンやクライアントごとに投稿にタグを付け、すべての一覧エンドポイントをラベルで絞り込めます。
ワークスペース
キーはワークスペースごとなので、あるクライアントが別のクライアントにアクセスすることはありません。