X（旧Twitter）APIエラーメッセージリファレンス

X（Twitter）APIのエラーメッセージ一覧表です。認証エラーから順に、各エラーの意味と対処法について解説します。

Twitterのフィードの代わりにエラーメッセージが表示されていますか？

このガイドでは、プラグインから表示される各メッセージの意味と、その対処法について解説します。必要なのは、WordPressのダッシュボードにアクセスできることだけです。

作業を始める前に、WordPressサイトに「Custom Twitter Feeds」の最新バージョンがインストールされ、有効化されていることを確認してください。

• エラーメッセージが表示される場所
• エラーメッセージ
• ライセンスキーの再有効化
• 接続の確認
• 自身のアプリで発生するエラー
• サーバーの要件
• それでもうまくいきませんか？
• よくある質問

エラーメッセージが表示される場所

フィードにツイートを表示できない場合、プラグインは通常フィードが表示される場所にメッセージを表示します。WordPressに管理者としてログインしている場合は、エラー内容と次の対処法が記載されたボックスが表示されます。

訪問者にはそのボックスは表示されません。フィードの代わりに、「現在、Twitterフィードはご利用いただけません」というメッセージが表示されます。

また、このプラグインは「システム情報」の「エラー」セクションに、日付付きの最近のメッセージ一覧を保存します。

エラーメッセージ

メッセージはアルファベット順に並んでいます。ご自身のページにあるメッセージを見つけてください。その後、最後の列の指示に従ってください。

メッセージ	その意味	どうすればいいか
エラー [番号]: [詳細]。	Smash Balloon API から、メッセージ自体が含まれていないエラーが返されました。	有料版をご利用の場合は、接続状態を確認してください。それでもメッセージが表示される場合は、メッセージ全文を添えてサポートチームまでご連絡ください。
HTTPリクエストエラー – [コード]: [詳細]	お使いのサーバーは、Smash Balloon API から応答を受け取れませんでした。詳細にその理由が記載されています。	有料版では、接続を確認してください。その後、サーバーの要件を確認してください。
フィードのモデレーション設定に合致するツイートは見つかりませんでした。	フィードのフィルター設定により、表示されるツイートがありません。	フィードのフィルターを編集して、より多くのツイートが表示されるようにするか、条件に合う新しいツイートが表示されるまでお待ちください。
[日付]時点で、このサイトにおける1日あたりのフィード更新回数の上限を超えたようです。	お客様のサイトでは、本日のフィード更新枠を使い切りました。そのため、新しいツイートは更新枠がリセットされるまで待機状態となります。基本ライセンスレベルでは12件、プラスライセンスレベルでは18件、エリートライセンスレベルでは24件が上限となっています。	特に何もする必要はありません。制限は24時間以内に自動的にリセットされます。無料版は週に1回更新されるため、制限は来週中にリセットされます。
ID [番号] のフィードが見つかりませんでした。	ショートコード内のフィードIDが、サイト上のフィードと一致していません。このページを開いたすべてのユーザーに、このメッセージが表示されます。	プラグインの「すべてのフィード」ページに移動し、目的のフィードのショートコードをコピーしてください。
選択したフィードソースに関するツイートは見つかりませんでした。	このフィードには、このプラグインが表示できるツイートがありません。ソースにツイートがないか、フィードのフィルターによってツイートが非表示になっているか、あるいはハッシュタグや検索フィードが7日間の制限に達している可能性があります。	フィード内のソースとフィルターを確認し、フィードのキャッシュをクリアしてください。
Smash Twitter API を使用するための認証情報に問題がある可能性があります	Smash Balloon API は、お客様のサイトの認証情報を承認しませんでした。	ライセンスキーを再有効化してください。無料版の場合は、サイトキーを更新してください。
リクエストが多すぎます	無料版では、APIが短時間に過剰なリクエストを受信した場合、このメッセージが表示されます。	フィードの次の更新を待ってください。それでもメッセージが表示されたままの場合は、サポートチームまでご連絡ください。
現在、Twitterのフィードはご利用いただけません。	エラーが発生した場合、訪問者にはフィードの代わりにこの画面が表示されます。	WordPressに管理者としてログインした状態でこのページを開くと、メッセージ全文を確認できます。
フィードの更新を完了できませんでした。お使いのライセンスキーは、このサイトからTwitter APIへのリクエストを行うための認証を受けていないようです。	Smash Balloon API は、このサイトのライセンスキーを受け付けませんでした。無料版では、このメッセージにサイトキーの名前が表示されます。	ライセンスキーを再有効化してください。無料版の場合は、サイトキーを更新してください。
お使いのサイトは smashballoon.com に接続できず、フィードの更新を開始できません。	お客様のサイトは、Smash Balloon とアクティブな接続が確立されていません。	ライセンスキーを再有効化してください。無料版の場合は、サイトキーを更新してください。

ライセンスキーの再有効化

「ライセンスキーを一度無効にしてから、再度有効にしてください」というメッセージがいくつか表示されます。この操作を行ってもライセンスキーは保存されたままですので、再度入力する必要はありません。

まず、WordPressのダッシュボードで「Twitter Feed」»「設定」に移動します。次に、「一般」タブの「ライセンスキー」セクションにある「無効化」をクリックします。

ステータスが「非アクティブ」に変わります。次に、「有効化」をクリックしてください。

ステータスが「アクティブ」に戻ります。

無料版をご利用の場合は、「Twitter Feeds」»「設定」に移動し、「サイトキー」の行にある「更新」をクリックしてください。その行に「接続」と表示されている場合は、まだサイトが接続されていません。無料版の設定方法については、当サイトのガイドで手順をご説明しています。

接続の確認

有料版には、お使いのサーバーからsmashballoon.comに接続できるかどうかを確認できるテスト機能が搭載されています。

これを実行するには、WordPressのダッシュボードで「Twitter Feed」»「設定」に移動してください。次に、「一般」タブの「ライセンスキー」セクションにある「接続テスト」をクリックしてください。

結果がリンクの代わりに表示されます。「接続に成功しました」と表示された場合は、サーバーが smashballoon.com に接続できたことを意味します。「接続に失敗しました」と表示された場合は、接続できなかったことを意味します。その横にある「エラーを表示」リンクをクリックすると、理由を確認できます。

このテストは smashballoon.com を確認するものであり、フィードの更新は ctf.smashballoon.com を通じて行われます。テストに失敗した場合、またはメッセージが表示されたままの場合は、以下のサーバー要件を確認してください。

自身のアプリで発生するエラー

「Connect your Own App (V2)」を使用して独自のアプリを連携させた場合、プラグインはSmash Balloon APIではなく、X APIを直接呼び出します。Xからのエラーは、システム情報の「ERRORS」セクションに保存されます。

そこで見つけた情報を読み解く方法は以下の通りです：

• 「Twitter API に接続できませんでした。ホスト側で接続がブロックされている可能性があります。」というメッセージは、サーバーが X API にアクセスできないことを意味します。この問題を解決するには、以下のサーバー要件を確認してください。
• キーやトークンに関するエラーは、Xがそれらを受け入れなかったことを意味します。この問題を解決するには、プラグイン内の「Consumer Key」、「Consumer Secret」、「Access Token」、「Access Token Secret」が、X上のアプリの情報と一致しているか確認してください。各情報の確認方法については、Xアプリの作成ガイドをご参照ください。

サーバーの要件

カスタムTwitterフィードには、PHP 7.4以降が必要です。有料版では、「MCP書き込みアクセス」オプションを利用するには、WordPress 6.9以降が必要です。

デフォルトの接続設定では、ctf.smashballoon.com の Smash Balloon API を通じてフィードが更新されます。この接続では WordPress HTTP API が使用されます。お使いのサーバーでは、そのアドレスへの HTTPS による外部への接続が許可されている必要があります。これらの接続がブロックされている場合は、ウェブホスティング業者に許可するよう依頼してください。

cURL および allow_url_fopen は、独自のアプリを接続し、リクエストメソッドを cURL または file_get_contents() に設定した場合にのみ関係します。その場合、プラグインはそのメソッドを使用して api.twitter.com の X API を呼び出します。サーバー側では、これに対応するオプションを設定する必要があります。

両方を確認するには、「システム情報」を開いてください。次に、PHPの「allow_url_fopen」と「cURL」の行を探してください。

「リクエストメソッド」は、プラグイン設定の「詳細」タブにあります。デフォルトでは「自動」に設定されています。独自のアプリを使用していて、Xに接続できない場合にのみ、この設定を変更する必要があります。

お使いのサーバーがこれらの要件を満たしているにもかかわらずエラーが表示される場合は、次のセクションでサポートを受ける方法について説明しています。

それでもうまくいきませんか？

それでもエラーメッセージが表示される場合は、弊社チームが詳しく調査いたします。サポートチームまでご連絡いただき、以下の詳細情報をお知らせください：

• エラーメッセージの全文
• フィードが掲載されているページのURL
• フィードの種類とソース
• これまでに試した対処法
• お使いのシステム情報

以上です！これで、各エラーメッセージの意味と、その解決方法がわかりましたね。次は、X APIの変更点に関するガイドをご覧になり、フィードの更新がどのように機能するかを学んでください。

よくある質問

以下では、カスタムTwitterフィードのエラーメッセージに関して、よく寄せられる質問のいくつかにお答えします。