AUTH311: RESTルートが見つかりません
これが意味すること
WCPOSのストアルートが利用できません。
セキュリティ系またはプロキシ系のプラグインがWCPOSのリクエストヘッダーを削除していないか、サイト管理者に確認を依頼してください。
対処方法
この機能を利用するには設定の変更が必要です。上記の変更を行ってから再試行してください。変更せずに再試行しても、同じように失敗します。
データへの影響
注文データや商品データへの影響はありません。この状態が続く場合は、WordPressサイトの管理担当者にお問い合わせください。
トラブルシューティング
- サイトでWCPOSが有効になっていることを確認してください: WP Admin → プラグイン。
- サポートされている2つのREST形式をブラウザーでテストしてください: ストアの /wp-json/ アドレスと /index.php?rest_route=/ です。どちらのアドレスもJSONを返さない場合にのみ、RESTがブロックされていると判断してください。
- どちらのREST形式も動作しない場合は、セキュリティプラグイン、プロキシ、CDNがWCPOSのリクエストヘッダーを削除していないか、またはRESTリクエストをブロックしていないかをサイト管理者に確認してください。ファイアウォールのルールや「REST APIを無効化する」といった強化オプションが原因であることがほとんどです。
- ホスティング環境によっては、パーマリンクを保存し直す（設定 → パーマリンク → 保存）ことで、失われたRESTルートが復旧します。
確認する場所
WCPOSがこのエラーを保存できた場合、そのエラーは発生したデバイス上に記録されます。ストアヘルス → ログ（ナビゲーションドロワー下部のハートビートアイコン）を開き、このコードが付いたエントリーを見つけて展開してください。展開された行には、平易な言葉で書かれた原因と、失敗した時点で取得されたコンテキストが表示されます。ストアへのリクエストの場合、そのコンテキストにはサーバー自身のエラーコード（serverCode）、HTTPの status、endpoint などが含まれることがあります。表示されるフィールドは、どこで失敗したかによって異なります。問題を報告する際は、スクリーンショットではなく、ログ画面上部の デバッグ情報をコピー（スマートフォンやタブレットでは デバッグ情報を共有）をご利用ください。アプリのバージョン、接続状態、直近のエラーがまとめて含まれます。ログの保存期間は最長30日間ですので、問題が新しいうちに収集してください。また、POSが自身のログエントリーを書き込めるようになる前にブラウザーのコンソールに表示されたエラーがあれば、それもコピーしてください。
アプリ内のログ以外にも、この失敗は次の場所に痕跡を残すことがあります。
- ネットワークインスペクター（ウェブおよびデスクトップ）: 開発者ツールを開き（ブラウザーではF12キー、デスクトップアプリではメニューの 詳細設定 → 開発者ツールの切り替え）、ネットワーク タブを選択します。まずこのページの再試行に関する案内に従ってください。操作を再現するのは、その手順で安全だと示されている場合のみにしてください。失敗したリクエストには、HTTPステータスと生のレスポンス本文（POSのログには届かないエラーページを含む）が表示されます。
- WooCommerce → ステータス → ログ: WordPressサイトで、最新の
fatal-errors-*.logにPHPのクラッシュがないか確認し、あわせて今回の失敗に関係するプラグイン名が付いたログソースも確認してください。ストアからの500番台のエラーは、ほぼ必ずここに原因が残ります。
詳細
- コード:
AUTH311(REST_ROUTE_MISSING) - 重大度: error
- 導入バージョン: WCPOS 1.10.0