Instagram API のエラー:主要なエラーコードの意味
Instagram API で最もよく見られるエラーは、期限切れまたは無効なトークンを示す 190、レート制限の 4、17、80002、Meta が取得できないメディアの 9004、処理中の動画の 9007、1 日の投稿上限の 9、メッセージ送信期間の外にある DM の 10(サブコード 2534022)です。各エラーは JSON で返され、カテゴリを示すコードと、多くの場合は具体的なケースを示すサブコード、そしてメッセージを含みます。
easyCoexistence は、これらのエラーの接続側を担当します。
期限切れ、取り消し済み、またはその他の理由で無効になったアクセストークンを示す Graph API コードです。
Instagram のビジネス利用ケースのレート制限を示すエラーコードです。
アカウントが 1 日の API 投稿上限に達したことを示す、コード 9 のサブコードです。
Meta が指定された URL からメディアを取得できなかったことを示す、コード 9004 のサブコードです。
アカウントが Instagram のメッセージへのアクセスをオフにしている場合の、コード 200 のサブコードです。
Instagram API のエラーはどう読めばよいですか?
すべてのエラーは error 内の JSON オブジェクトです。code は大まかなカテゴリ、error_subcode は具体的なケースを示し、通常はこちらの方が役立ちます。message はエラーの内容を説明します。多くのエラーには、利用者向けのテキストである error_user_title と error_user_msg、そして is_transient も含まれます。fbtrace_id はリクエストを Meta サポートに示す識別子で、すぐに失効するため、エラー発生時にログへ記録してください。
アクセスと権限のエラーはどのような意味ですか?
誰が何をできるかに関するエラーです。それぞれの修正方法は次のとおりです:
- 190:アクセストークンが期限切れ、取り消し済み、またはその他の理由で無効です。サブコード 463 は期限切れ、467 は無効、460 はパスワード変更を意味します。新しいトークンを取得すれば解決します。接続済みのアカウントの場合は、再接続が必要です。
- 10:権限が拒否されました。権限が付与されていないか、後から削除されています。
- 200 から 299:特定の権限が不足しています。例えば、アカウントがメッセージへのアクセスをオフにしている場合は、200 とサブコード 2534041 になります。
- 25、サブコード 2207050:アカウントが制限・非アクティブ化されているか、チェックポイントで止められています。オーナーが Instagram アプリにサインインし、求められた内容を完了する必要があります。
レート制限のエラーはどのような意味ですか?
スロットリングです。いずれも一時的なものです:
- 4:アプリからの呼び出しが多すぎます。待ってから再試行するか、リクエストの量を減らしてください。
- 17:ユーザーに対する呼び出しが多すぎます。対処法は同じです。
- 80002:Instagram のビジネス利用ケースの制限です。アプリとアカウントごとに、アカウントのインプレッションに基づいて算出されます。24 時間で、インプレッションあたり 4,800 回の呼び出しです。
- 613、サブコード 2534040:メッセージング関連の呼び出しが多すぎます。一時停止して、後で再試行してください。
メディアに関する投稿エラーはどのような意味ですか?
ファイルとそのホスティング先に関するエラーです。現状のまま再試行する価値があるのはタイムアウトだけです:
- 9004、サブコード 2207052:Meta が URL からメディアを取得できませんでした。URL が有効で公開されていることを確認してください。
- -2、サブコード 2207003:ダウンロードに時間がかかりすぎました。これは再試行する価値があります。
- 36000、サブコード 2207004:画像が 8 MB を超えています。
- 36001、サブコード 2207005:画像形式がサポートされていません。JPEG を使用してください。
- 36003、サブコード 2207009:アスペクト比が 4:5 から 1.91:1 の範囲外です。
- 352、サブコード 2207026:動画形式がサポートされていません。MOV または MP4 を使用してください。
投稿のタイミングと上限に関するエラーはどのような意味ですか?
いつ、どれだけかに関するエラーです。多くは待つか、やり直すことで解決します:
- 9007、サブコード 2207027:メディアの準備ができていません。コンテナの
status_codeが FINISHED と表示されるまで待ってください。 - 24、サブコード 2207008:コンテナが存在しないか、期限切れです。30 秒から 2 分の間に 1 回か 2 回再試行し、それでもだめなら新しく作成してください。
- -2、サブコード 2207020:メディアが期限切れです。新しいコンテナを作成してください。
- 9、サブコード 2207042:アカウントが 1 日の投稿上限に達しました。翌日に再試行してください。
- 100、サブコード 2207028:カルーセルには 2 から 10 個のアイテムが必要です。
- 36004、サブコード 2207010:キャプションが長すぎます。Meta の上限は 2,200 文字と @ タグ 20 個で、リファレンスではハッシュタグは 30 個とされていますが、Instagram では投稿につき 5 個まで許可されています。
- 4、サブコード 2207051:スパムの疑いがあるとして、Instagram がこの操作を制限しました。
メッセージ関連のエラーはどのような意味ですか?
DM とプライベートリプライに関するエラーです:
- 10、サブコード 2534022:許可された期間の外にメッセージが送信されました。相手が再度メッセージを送ってくるのを待ってください。
- 100、サブコード 2534014:一致する Instagram ユーザーがいません。Webhook から得た Instagram スコープ ID を使用し、Instagram ユーザー ID は使わないでください。
- 100、サブコード 2534025:そのコメントにはプライベートリプライを送信できません。
- 100、サブコード 2534037:別のアプリ(Meta 自身の Business AI を含む)が会話を管理しています。
- 551、サブコード 1545041:相手が現在利用できない状態です。
インサイトのエラーはどのような意味ですか?
インサイトのリクエストは、文書化された 3 つの方法で失敗します:
- 10、視聴者が少なくてメディアのインサイトを表示できません。ストーリーの指標が 5 未満の場合です。
- 2025 年 4 月 21 日以降のインプレッションのように、廃止された指標はエラーを返します。代わりに views をリクエストしてください。
- リクエストした複数の指標のうち 1 つが、要求された内訳に対応していない場合、不明なエラーが返されます。
再試行する価値があるエラーはどれですか?
一時的なものだけです。コード 1 と 2、Instagram のサーバーエラー 2207001 と 2207032、ダウンロードのタイムアウト 2207003、短時間で解消される 2207008、そして待機時間が過ぎたレート制限です。それ以外は、ファイル、URL、権限、アカウントの状態、または相手との送信可能期間が変わるまで同じ結果を返すため、再試行してもレート制限を消費するだけです。
よくある間違い
- 形式やサイズのエラーを再試行すること。2207004、2207005、2207009、2207026 は、メディアが変わるまで同じように失敗します。
- 9007 を失敗として扱うこと。動画はまだ処理中です。コンテナが FINISHED と表示されたら投稿してください。
- コードだけを読むこと。10 や 100 のようなコードは多くのケースを含み、どのケースかを示すのはサブコードです。
- ログから fbtrace_id を省くこと。Meta サポートがこれを求め、エラーの直後にすぐ失効します。
Instagram のアクセスは期限切れ前に更新し、6 時間ごとにアカウントを確認し、再接続が必要になるとメールでお知らせします。Claude、ChatGPT、または独自のコードは、常に最新に保たれたトークンを使って Meta の公式 API を呼び出します。接続ごとに月額 US$ 9 から US$ 0.75 まで、接続を増やすほど下がります。最初の 3 日間は無料トライアルです。
よくある質問
Instagram のエラー 190 はどのような意味ですか?
アクセストークンが期限切れ、取り消し済み、またはその他の理由で無効になっています。例えばパスワードを変更した後などです。新しいトークンを取得すれば解決し、接続済みのアカウントの場合は再接続が必要です。
9004 で投稿が失敗するのはなぜですか?
Meta が指定された URL からメディアを取得できなかったためで、サブコードは 2207052 です。投稿時点で、リンクが有効で公開されており、前にログインが必要な画面がないか確認してください。
エラー 9007 とは何ですか?
コンテナ内の動画がまだ処理中であることを示し、サブコードは 2207027 です。コンテナの status_code を確認し、FINISHED と表示されたら投稿してください。
Instagram API エラーの fbtrace_id とは何ですか?
失敗したリクエストを識別する ID で、問題を報告する際に Meta サポートが求めます。エラーの直後にすぐ失効するため、発生時点でログに書き留めてください。
続きを読む
最初のチャンネルを 2 分で接続しましょう。
プラットフォームの審査を待つ必要はありません。WhatsApp、Instagram、TikTok などのチャンネルを接続して、AI に投稿、返信、レポートを任せてみてください。
- 3 日間無料
- いつでも解約可能
- 公式 API のみ使用
- 24/7 監視
確認日