API でソーシャルメディアのスケジューラーを構築する方法: キュー、メディア、投稿ステータス
easyCoexistence の Partner API でソーシャルメディアのスケジューラーを構築するには、バックエンドから POST /channels/:id/posts に、本文、メディア、1 分後から 90 日後までの publish_at を含む投稿を送信します。easyCoexistence は直ちにメディアをコピーし、指定時刻に Instagram、Facebook、TikTok、LinkedIn へ投稿します。各段階はステータスとして返され、post.published および post.failed イベントでも通知されます。
投稿 API が Instagram、Facebook、TikTok、LinkedIn で予約できる期間。最短は 1 分後です。
投稿の予約時にコピーされる画像と動画の最大サイズ。これを超えるファイルは、その時点で拒否されます。
ネットワークからレート制限を受けた投稿は、失敗とマークされる前に再試行されます。
Instagram アカウントが直近 24 時間に行える API 投稿の上限。カルーセルは 1 件として数えます。
公開用エンドポイント経由での TikTok の動画投稿数の上限。1 分あたり最大 6 件です。
スケジューラーには API から何が必要ですか?
5 つの要素が必要です。ファイルをアップロードする場所、1 つのアカウントに対して投稿をキューに入れる呼び出し、時刻どおりに公開するキュー、予約を変更する手段、そして結果の通知です。Partner API の投稿 API は、顧客の接続に使う同じ ec_live_ キーでこれらすべてを提供するため、カレンダー、承認フロー、投稿作成画面は自社の製品内に残ります。
投稿はどのようにスケジュールしますか?
アカウントごとに 1 回、https://easycoexistence.com/api/v1/channels/:id/posts に POST します。:id は顧客の接続セッションにある channel_id です。publish_at は Z またはオフセット付きの ISO 8601 形式で指定します。省略すると即時公開になります。成功すると投稿を含む 201 が返り、即時公開の投稿の作成に失敗した場合は 422 が返ります。Idempotency-Key ヘッダーに対応しているため、タイムアウト後に繰り返したリクエストで投稿が 2 重にキューへ入ることはありません。リクエストボディには次の項目を指定します:
- text: キャプション、メッセージ、またはコメント。media: {url, type} または {
media_id} のリスト。 - link: Facebook のリンク投稿、または LinkedIn の記事。LinkedIn ではタイトルも指定します。
ig_type: IMAGE、CAROUSEL、REELS、STORIES のいずれか。省略するとメディアから推測されます。- TikTok の写真投稿では title と
disable_comment、LinkedIn の画像ではimage_altを指定します。
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 がファイルをコピーするため、リンクが機能している必要があるのはその時点だけです。ファイルの代わりの Web ページ、404、種類の誤り、画像は 30 MB、動画は 1 GB を超えるファイルは、投稿当日の朝ではなく、予約した時点で拒否されます。
各ネットワークの投稿には何を含められますか?
キューは受け付ける前に、各投稿をそのネットワークのルールと照合します。ルールに違反する投稿は、違反したルールを示すメッセージとともに拒否されるため、ユーザーが編集している間に、投稿作成画面で問題を表示できます。各ネットワークが受け付ける内容は次のとおりです:
投稿はどのステータスを経由しますか?
6 種類あります。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 は 1 つのアカウントの投稿を一覧表示します。バックグラウンドで失敗した投稿は、アカウントのオーナーにもメールで通知されます。通知はチャンネルごとに 3 時間に最大 1 回です。
LinkedIn の投稿はスケジューラーにどう組み込みますか?
投稿ごとに担当者が承認する形で組み込みます。LinkedIn の API 利用規約は、投稿を自動化するための API 利用を制限しています。そのためスケジューラーは、指名された担当者が承認するまで、すべての LinkedIn 投稿を自社製品内の下書きとして保持し、承認後に publish_at とともに送信します。定期ルール、フィード、一括インポートは他のネットワークを対象にし、LinkedIn は担当者がレビューした投稿だけに限定してください。
よくある間違い
- publish_at にオフセットを付けずに送ること。Z もオフセットもないローカル時刻は拒否されます。ユーザーが選んだ時刻をそのまま送らず、2026-11-20T09:00:00-05:00 のように送ってください。
- may_be_published とマークされた投稿をすぐに再試行すること。ネットワーク側にすでに表示されている可能性があるため、先にアカウントを確認してください。確認しないと、投稿が 2 回公開されます。
- Idempotency-Key を付けずにタイムアウトした POST を繰り返すこと。投稿ごとに固有のキーを付けてください。そうすれば、繰り返したリクエストは 2 件目を予約せず、すでにキューに入っている投稿を返します。
- Instagram 向けに PNG ファイルをリンクすること。Instagram の公開 API は JPEG のみを受け付け、予約時に PNG は拒否されます。画像はアップロード処理の段階で変換してください。
easyCoexistence は、顧客の Instagram、Facebook、TikTok、LinkedIn アカウントを 1 つのキューで管理できるようにし、ほかのチャンネルも順次追加しています。各ネットワークの公式 API を通じて、予約時にメディアをコピーし、6 種類のステータス、レート制限への再試行、署名付きの投稿イベントを提供します。すべての接続は 24/7 で監視されます。料金は接続 1 件あたり月額 US$ 9 から、接続を増やすほど下がり US$ 0.75 まで。最初の 3 日間は無料です。
よくある質問
1 回のリクエストで複数のネットワークに投稿を予約できますか?
1 回のリクエストは 1 つのチャンネルを対象にします。そのため、アカウントごとに 1 件ずつ、それぞれ固有の Idempotency-Key を付けて送り、テキストは各ネットワークの上限に合わせて調整してください。
投稿 API で YouTube の動画を予約できますか?
YouTube はネイティブに予約できます。GET /channels/:id?credentials=1 で取得したトークンを使い、YouTube の API で publishAt を付けた非公開の動画としてアップロードしてください。その時刻になると、YouTube が自動で公開します。
ユーザーは easyCoexistence のダッシュボードで予約投稿を見られますか?
Posts 画面はお客様のアカウントに属するため、チームは「Needs attention」「Coming up」「Published」を確認でき、「Cancel」「Retry」「Dismiss」を操作できます。お客様は、自社製品が GET /posts から構築するカレンダーを見ます。
easyCoexistence のソーシャルメディアスケジューラーにかかる費用は?
接続済みアカウント 1 件あたり月額 US$ 9 から、接続を増やすほど下がり US$ 0.75 まで。予約機能は含まれ、最初の 3 日間は無料です。
続きを読む
最初のチャンネルを 2 分で接続しましょう。
プラットフォームの審査を待つ必要はありません。WhatsApp、Instagram、TikTok などのチャンネルを接続して、AI に投稿、返信、レポートを任せてみてください。
- 3 日間無料
- いつでも解約可能
- 公式 API のみ使用
- 24/7 監視
確認日