WordPress REST APIで記事更新を送信しても、サイト上の文章が変わらないことがあります。APIが失敗している場合と、更新は成功しているのにキャッシュや編集対象の違いで反映されない場合を分けて確認しましょう。
最初にAPIのレスポンスを確認
更新リクエストのHTTPステータス、投稿ID、modified日時、contentなどを確認します。エラーが返っている場合は、表示キャッシュを調べる前に認証・権限・リクエスト形式を点検します。
原因1:更新先の投稿IDが違う
スラッグだけで対象を推測すると、別の記事を更新する場合があります。更新前にGETで投稿IDとタイトルを照合し、PUTまたはPOSTの更新先URLが正しいか確認しましょう。
原因2:キャッシュが古い
WordPressキャッシュプラグイン、CDN、サーバーキャッシュ、ブラウザーキャッシュなどが古いページを返すことがあります。管理画面の本文と公開ページを比較し、必要なキャッシュのみ削除して確認します。
原因3:編集対象がpost_contentではない
一部のページビルダーは、表示用の本文をカスタムフィールド等に保存します。通常のpost_contentだけ更新しても、実際のページ表示が変わらない場合があります。使用中のビルダーに適した編集手段を確認しましょう。
原因4:権限・認証・REST API設定
アプリケーションパスワードやユーザー権限が不足していると更新が拒否されます。401・403などのエラー内容を確認し、必要以上に権限を広げないようにします。
原因5:Gutenbergブロックの形式
ブロックコメントとHTMLの構造が崩れていると、編集画面でブロックの修復が求められる場合があります。更新後に表示だけでなく編集画面でも確認しましょう。
原因6:別の自動処理による上書き
予約処理、外部連携、複数のAIワークフローが同じ記事を更新すると、後の処理で内容が戻ることがあります。更新日時と実行ログを比較し、同一記事の同時更新を避けます。
安全な確認手順
更新前に対象IDと内容を確認し、小さな変更でテストします。更新レスポンスを確認した後にGETで保存値を読み直し、公開ページも確認します。大規模な一括更新はバックアップと復元手順を用意しましょう。
まとめ
更新が保存されていないのか、保存された内容が表示されないのかを切り分けると原因を特定しやすくなります。