ログイン無料トライアルを開始
easyCoexistence 公式 API

API でソーシャルメディアのスケジューラーを構築する方法: キュー、メディア、投稿ステータス

easyCoexistence の Partner API でソーシャルメディアのスケジューラーを構築するには、バックエンドから POST /channels/:id/posts に、本文、メディア、1 分後から 90 日後までの publish_at を含む投稿を送信します。easyCoexistence は直ちにメディアをコピーし、指定時刻に Instagram、Facebook、TikTok、LinkedIn へ投稿します。各段階はステータスとして返され、post.published および post.failed イベントでも通知されます。

90 days

投稿 API が Instagram、Facebook、TikTok、LinkedIn で予約できる期間。最短は 1 分後です。

30 MB and 1 GB

投稿の予約時にコピーされる画像と動画の最大サイズ。これを超えるファイルは、その時点で拒否されます。

5 min, 30 min, 2 h

ネットワークからレート制限を受けた投稿は、失敗とマークされる前に再試行されます。

100 posts

Instagram アカウントが直近 24 時間に行える API 投稿の上限。カルーセルは 1 件として数えます。

15 a day

公開用エンドポイント経由での TikTok の動画投稿数の上限。1 分あたり最大 6 件です。

スケジューラーには API から何が必要ですか?

5 つの要素が必要です。ファイルをアップロードする場所、1 つのアカウントに対して投稿をキューに入れる呼び出し、時刻どおりに公開するキュー、予約を変更する手段、そして結果の通知です。Partner API の投稿 API は、顧客の接続に使う同じ ec_live_ キーでこれらすべてを提供するため、カレンダー、承認フロー、投稿作成画面は自社の製品内に残ります。

1UploadPOST /media, or a public HTTPS link
2SchedulePOST /channels/:id/posts with publish_at
3HoldMedia copied, the post waits in the queue
4PublishThe network's official API, at the set time
5ReportStatus on GET /posts; post.published or post.failed

投稿はどのようにスケジュールしますか?

アカウントごとに 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 を指定します。
Schedule an Instagram carousel
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 を超えるファイルは、投稿当日の朝ではなく、予約した時点で拒否されます。

各ネットワークの投稿には何を含められますか?

キューは受け付ける前に、各投稿をそのネットワークのルールと照合します。ルールに違反する投稿は、違反したルールを示すメッセージとともに拒否されるため、ユーザーが編集している間に、投稿作成画面で問題を表示できます。各ネットワークが受け付ける内容は次のとおりです:

InstagramOne JPEG, a carousel of 2 to 10 items, a Reel or a Story; up to 2,200 characters; no link.
FacebookText, a link, one image or one video on a Page, never a link and a file together.
TikTokOne video, or 1 to 35 JPEG or WebP images with a title of up to 90 characters.
LinkedInText of up to 3,000 characters with one image or a titled link; no video.

投稿はどのステータスを経由しますか?

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 で実現する

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 監視

確認日