WordPress REST APIで404が返るときは、URL・HTTPメソッド・パーマリンク設定・プラグインによる制限を順に確認しましょう。特にrest_no_routeは、指定したルートとメソッドの組み合わせが見つからない場合に返される代表的なエラーです。
REST APIの404と記事ページの404は別
記事URLが404になることと、REST APIのエンドポイントが404になることは異なります。まずリクエスト先が /wp-json/wp/v2/posts のようなAPI URLになっているかを確認します。
rest_no_routeとは
REST APIが該当するルートとリクエストメソッドを認識できない場合などに返されるエラーコードです。URLの打ち間違いやGETとPOSTの取り違えを確認します。
原因1:API URLが間違っている
サイトURLとWordPressの設置URLが異なる環境では、APIの基点が想定と違うことがあります。ブラウザで /wp-json/ を開き、利用可能なルートを確認しましょう。
原因2:HTTPメソッドの指定ミス
記事一覧取得はGET、記事作成はPOSTです。存在するURLでも対応していないメソッドを指定するとエラーになります。利用するエンドポイントの仕様を照合します。
原因3:パーマリンクやリライトルール
WordPressのリライトルールが正常に動いていないと /wp-json/ にアクセスできないことがあります。管理画面のパーマリンク設定を確認し、変更前に現在の設定を控えておきます。
原因4:セキュリティ設定やWAF
セキュリティプラグインやサーバー側の設定によってREST APIが制限される場合があります。応答本文がWordPressのJSONか、サーバー独自のHTMLエラーページかを確認すると切り分けに役立ちます。
原因5:存在しない投稿IDを指定
/wp/v2/posts/999999 のように存在しない投稿IDを取得すると404になる場合があります。投稿一覧から実際のIDを取得して再試行しましょう。
確認する順番
① /wp-json/ の応答を確認、② /wp-json/wp/v2/posts をGET、③使用メソッドとURLを照合、④APIのエラーコードとメッセージを保存、⑤必要に応じてプラグイン・サーバーログを確認します。
AI自動投稿での予防策
APIルートを定数として管理し、投稿IDを保存し、404発生時に同じリクエストを無制限に再送しない仕組みにします。認証情報をログに残さないことも重要です。
まとめ
REST APIの404はURL・メソッド・ルート・投稿ID・サーバー設定の順に確認すると原因を絞れます。