MENU

WordPress REST APIでできること|記事投稿・更新・メディア管理の全体像

当ページのリンクには広告(PR)が含まれていることがあります。
WordPress REST API できることの確認手順を示す図解

WordPress REST APIで何ができるのか全体像が分からない。

記事投稿以外に、画像やカテゴリも扱えるのか知りたい。

認証や公開ミスが怖く、いきなり自動投稿するのが不安。

なべくんです。

結論から言うと、WordPress REST APIは記事、カテゴリ、タグ、メディアなどを外部ツールから扱えますが、最初は下書き作成と取得確認から始めるのが安全です

ただし、便利そうに見える作業ほど、最初に確認しておくことがあります。APIキー、外部サービス、スクレイピング、WordPress連携、GASの権限まわりは、動くかどうかだけでなく「安全に続けられるか」まで見ておきましょう。

この記事では、API運用の全体を知りたい 方に向けて、手元で試せる順番に整理します。

目次

この記事で分かること

  • WordPress REST APIの全体像
  • 記事投稿と更新の違い
  • メディア管理の考え方
  • 安全な始め方

先に注意点

注意点 理由
小さく1件だけ試す まとめて動かすと、失敗した時に原因を切り分けにくいため
認証情報をコードに直書きしない 共有やGit管理で漏れると、外部から使われる可能性があるため
公式情報を確認する 画面、API、制限、料金、規約は変わる可能性があるため
ログと実行結果を残す 後から同じエラーを見た時に、確認順を再利用できるため
実務投入前に手動確認を挟む 誤送信、誤投稿、過剰アクセスを避けるため

WordPress REST APIは外部からWordPressを操作する入口です

WordPress REST APIの全体像
WordPress REST APIは外部からWordPressを操作する入口です

この見出しの結論: 投稿、固定ページ、カテゴリ、タグ、メディアなどをHTTPで扱えます。

WordPress REST APIは、WordPressのデータを外部ツールから取得・作成・更新するための仕組みです。ブログ運営では、下書き作成、カテゴリ取得、画像アップロード、既存記事の更新などに使えます。

最初はGETで取得確認をします

GETで記事一覧を取得する流れ
最初はGETで取得確認をします

この見出しの結論: 書き込みより先に、読み取りでURLとレスポンスを確認します。

いきなり投稿を作る前に、まず記事一覧を取得してREST APIが動いているか確認しましょう。公開情報の取得であれば認証なしで見える範囲もあります。

投稿作成はdraftから始めます

draft投稿から確認して公開する流れ
投稿作成はdraftから始めます

この見出しの結論: publishではなくdraftにすることで、公開ミスを防ぎます。

WordPress REST APIで記事を作る時は、statusをdraftにして下書き作成するのが安全です。本文崩れ、カテゴリ間違い、画像未設定のまま公開される事故を避けられます。

メディアとアイキャッチは別で考えます

メディアアップロードと投稿紐付けの図
メディアとアイキャッチは別で考えます

この見出しの結論: 画像アップロードと投稿への紐付けは、処理を分けて確認します。

画像をアップロードしただけでは、必ずしも記事のアイキャッチになるわけではありません。メディア登録でIDを取得し、投稿側にfeatured_mediaとして設定する流れを理解しておきましょう。

エラーはHTTPステータスで切り分けます

WordPress REST APIエラー切り分け表
エラーはHTTPステータスで切り分けます

この見出しの結論: 401、403、400などの意味を見れば、次に確認する場所が絞れます。

401は認証、403は権限やセキュリティ設定、400はリクエスト内容に原因があることが多いです。エラー本文も一緒に保存しておくと、原因を追いやすくなります。

実務で使う前のチェックリスト

  • 入力データに個人情報や機密情報が含まれていないか。
  • 実行環境、ライブラリ、APIのバージョンをメモしたか。
  • 1件だけテストして、成功時の出力を確認したか。
  • エラー時に見る場所を決めたか。
  • 外部サービスの規約、料金、アクセス制限を確認したか。
  • 同じ処理を何度も実行しても事故にならないか。
要約 この記事の確認順
要約 この記事の確認順

よくある質問

WordPress REST APIで記事を公開できますか?

できます。ただし最初はdraftで下書き作成し、管理画面で確認してから公開するのがおすすめです。

画像もAPIで扱えますか?

メディアエンドポイントを使うとアップロードできます。アイキャッチ設定は投稿側のfeatured_mediaも確認します。

認証には何を使いますか?

通常はApplication Passwordなど、API連携用の認証情報を使います。コードへの直書きは避けましょう。

APIが使えない時は何を見ますか?

URL、HTTPS、認証、権限、REST API無効化設定、セキュリティプラグイン、HTTPステータスを順に確認します。

次に読む記事

参考URL

  • WordPress REST API Handbook: https://developer.wordpress.org/rest-api/
  • WordPress REST API Posts: https://developer.wordpress.org/rest-api/reference/posts/
  • Application Passwords: https://developer.wordpress.org/advanced-administration/security/application-passwords/

まとめ

WordPress REST API できること は、最初から完璧に理解しようとすると手が止まりやすいテーマです。まずは小さく動かし、成功時の出力とエラー時の見る場所を残しておくと、次の作業がかなり楽になります。

同じような課題に直面している方の助けになれば幸いです。

この記事を書いた人

Watanabeのアバター Watanabe サイト運営者

2020年よりブログ開始。
SEOが思いのほか性にあっていたようで現在に至る。
モットーは「勝率の高い選択をする」
AIは活用するが吉、最後は人間が息を吹き込む。
アートと科学を追求し、日々精進。
―――
収益:6~7桁をウゴウゴ。
サイト:ペラサイト~中規模サイトまで運営中。
案件:1000円以上の案件をメインに取組中。
打ち手:ブラックSEO~ホワイトSEOまで
―――

目次