WordPress APIの種類｜REST API・XML-RPC・内部APIの違いを整理
WordPress APIの全体像
- WordPress APIは、外部連携用と内部処理用に分けると理解しやすくなります。
- 投稿管理ではREST API、テーマやプラグイン開発では内部APIが重要です。
- 用途ごとにAPIを選ぶことで、WordPress運用を効率化できます。
WordPress APIは、WordPressの機能を外部から操作したり、テーマやプラグインの中で安全に機能を呼び出したりするための仕組みです。記事投稿やメディアアップロードのような外部連携ではREST APIが中心になります。一方で、テーマやプラグイン開発では、Hooks APIやOptions APIなどの内部APIが重要になります。
「API」という言葉だけを見ると難しく感じますが、実務では「外部から使うAPI」と「WordPress内部で使うAPI」に分けると理解しやすくなります。
| 分類 | 主なAPI | 使う場面 | 代表例 |
|---|---|---|---|
| 外部連携API | REST API | 外部アプリ、Codex、自動投稿、管理ツール連携 | 投稿作成、メディアアップロード、カテゴリ取得 |
| 旧来の外部連携API | XML-RPC API | 古い投稿ツール、リモート投稿 | 外部エディターからの投稿 |
| 内部拡張API | Hooks API | テーマ・プラグインの機能追加 | アクション、フィルター |
| 設定管理API | Options API / Settings API | サイト設定やプラグイン設定の保存 | 設定値の保存、管理画面設定 |
| 通信・一時保存API | HTTP API / Transients API | 外部サイト通信、キャッシュ | 外部API取得、一時データ保存 |
REST API
- 外部ツールから投稿、固定ページ、メディアなどを操作できます。
- Codexや管理スクリプトで自動投稿を行う場合の中心になるAPIです。
- 認証や権限設定を確認して、安全に使うことが大切です。
WordPress REST APIは、外部アプリやツールからWordPressのデータを取得・作成・更新・削除するためのAPIです。投稿、固定ページ、カテゴリ、タグ、メディア、ユーザーなどをJSON形式で扱えます。
KOPENGUIN.COMでCodexから記事を投稿したり、アイキャッチ画像をメディアへアップロードしたりする作業も、REST APIを使う運用に近い考え方です。現在のWordPress自動化では、もっとも重要なAPIといえます。
| 項目 | 内容 | 実務での使い方 |
|---|---|---|
| データ形式 | JSON | 外部ツールと連携しやすい |
| 主な対象 | 投稿、固定ページ、メディア、カテゴリ、タグ | 記事管理や一括整理に使いやすい |
| 認証 | アプリケーションパスワードなど | Codexや管理スクリプトから操作できる |
| 向いている用途 | 自動投稿、外部管理画面、データ取得 | 大規模サイト管理に向いている |
XML-RPC API
- REST API以前から使われてきた旧来の外部連携APIです。
- 古い投稿ツールや外部エディターとの連携で使われる場合があります。
- 現在の新規運用では、REST APIを優先して検討します。
XML-RPC APIは、WordPressを外部から操作するために使われてきた旧来のAPIです。REST APIが広く使われる前から、外部エディターや投稿ツールとの連携に利用されてきました。
現在はREST APIを中心に考える場面が増えています。ただし、古い投稿ツールや一部サービスではXML-RPCを前提にしている場合があります。セキュリティ面の確認が必要になるため、使わない場合は制限する運用も検討されます。
| 項目 | XML-RPC API | REST API |
|---|---|---|
| 位置づけ | 旧来の外部連携API | 現在の外部連携の中心 |
| データ形式 | XML | JSON |
| 主な用途 | 古い投稿ツール、リモート投稿 | 自動投稿、管理ツール、アプリ連携 |
| 運用上の注意 | 不要なら制限を検討 | 認証と権限管理を行う |
Hooks API
- テーマやプラグインの処理を追加・変更するための内部APIです。
- アクションとフィルターを使い、WordPressの動作に処理を差し込めます。
- カスタマイズや機能追加では最も基本になる仕組みです。
Hooks APIは、WordPressの動作に処理を追加したり、出力内容を変更したりするための仕組みです。主にテーマやプラグイン開発で使われます。
Hooks APIには、処理を追加するアクションと、値を変更するフィルターがあります。WordPress本体を直接書き換えずに機能を追加できるため、拡張性を支える重要なAPIです。
| 種類 | 役割 | 使う場面 |
|---|---|---|
| Action | 特定のタイミングで処理を追加する | 投稿保存時に処理を追加する |
| Filter | 表示や値を変更する | 本文表示、タイトル、抜粋を調整する |
| Custom Hook | 独自の拡張ポイントを作る | 自作テーマやプラグインの拡張性を高める |
Options APIとSettings API
- サイト設定やプラグイン設定を保存・管理するためのAPIです。
- Options APIは設定値の保存、Settings APIは管理画面の設定項目作成に使います。
- 設定画面を持つプラグインでは特に重要です。
Options APIは、WordPressの設定値をデータベースに保存・取得するためのAPIです。サイト名、テーマ設定、プラグイン設定など、WordPressの多くの設定管理に関係します。
Settings APIは、管理画面に設定項目を追加し、安全に保存するための仕組みです。プラグインやテーマで設定画面を作る場合に使われます。
| API | 役割 | 使う場面 |
|---|---|---|
| Options API | 設定値を保存・取得する | サイト設定、テーマ設定、プラグイン設定 |
| Settings API | 管理画面の設定項目を作る | プラグイン設定画面、テーマ設定画面 |
| 違い | Optionsは保存処理、Settingsは管理画面側の仕組み | 設定機能を作るときは両方を組み合わせる |
HTTP APIとTransients API
- HTTP APIは外部サービスとの通信に使います。
- Transients APIは一時的なデータ保存やキャッシュに使います。
- 外部API連携では、通信とキャッシュを組み合わせると安定します。
HTTP APIは、WordPressから外部サービスへ通信するためのAPIです。外部のJSONデータを取得したり、別サービスへリクエストを送ったりする場合に使われます。
Transients APIは、一時的なデータを保存するためのAPIです。外部APIから取得した情報を毎回取りに行くのではなく、一定時間だけ保存しておくことで、サイト表示を軽くできます。
| API | 役割 | 具体例 |
|---|---|---|
| HTTP API | 外部サービスと通信する | 外部API取得、在庫情報取得、分析データ取得 |
| Transients API | 一時データを保存する | 外部データのキャッシュ、ランキング結果の一時保存 |
| 組み合わせ | 取得した外部データを一時保存する | 表示速度と外部API負荷を抑える |
投稿管理で重要なAPI
- 記事投稿やカテゴリ整理ではREST APIの理解が特に重要です。
- サイト内部の表示や設定変更ではHooks APIや設定系APIも関係します。
- 目的別にAPIを選ぶと、自動化や保守の見通しが良くなります。
WordPressを大規模に管理する場合、すべてのAPIを同じ深さで覚える必要はありません。投稿整理、カテゴリ整理、アイキャッチ設定、内部リンク調整では、まずREST APIを中心に理解するのが効率的です。
テーマやCocoon装飾を深く変更する段階ではHooks API、サイト設定やプラグイン設定を扱う段階ではOptions APIやSettings APIを確認します。
| やりたいこと | 関係するAPI | 優先度 |
|---|---|---|
| 記事を作成・公開する | REST API | 高 |
| アイキャッチをアップロードする | REST API Media | 高 |
| カテゴリやタグを整理する | REST API Terms | 高 |
| テーマ表示を調整する | Hooks API | 中 |
| プラグイン設定を作る | Options API / Settings API | 中 |
| 外部データを取得する | HTTP API / Transients API | 中 |
関連ページ
- WordPress APIを使った実作業は、接続方法や投稿運用の記事と合わせて読むと理解しやすくなります。
- CodexからWordPressを操作する場合は、REST APIとアプリケーションパスワードの知識が役立ちます。
WordPress APIを実際の運用に使う場合は、REST APIやJSONの基礎もあわせて確認すると理解しやすくなります。KOPENGUIN.COMでは、WordPress REST API、JSONとは、WordPress APIの歴史もご紹介しています。
| 関連記事 | 読む目的 |
|---|---|
| WordPress REST API | 外部から投稿やメディアを操作する仕組みを確認する |
| JSONとは | REST APIで使われるデータ形式を理解する |
| WordPress APIの歴史 | XML-RPCからREST APIへの流れを整理する |
公式情報・参考ページ
- APIの仕様は変更されることがあるため、公式情報で確認することが大切です。
- REST API、Hooks API、Settings APIなどは用途ごとに公式ドキュメントが分かれています。
WordPress APIは、機能ごとに公式ドキュメントが分かれています。実装や管理方針を決める場合は、対象APIの公式ページで確認すると安全です。
| API | 公式情報 | 確認できる内容 |
|---|---|---|
| REST API | WordPress REST API Handbook | REST APIの概要とエンドポイント |
| WordPress APIs | Common APIs Handbook | WordPress内部APIの一覧 |
| Hooks API | Plugin Handbook Hooks | アクションとフィルター |
| Options API | Options API | 設定値の保存と取得 |
| Settings API | Settings API | 管理画面の設定項目 |
| HTTP API | HTTP API | 外部サービスへのHTTPリクエスト |
| Transients API | Transients API | 一時データ保存とキャッシュ |
| XML-RPC | XML-RPC WordPress API | 旧来のリモート投稿API |
まとめ
- WordPress APIは、外部連携と内部拡張の両面から整理すると理解しやすくなります。
- 自動投稿ではREST API、テーマやプラグイン開発では内部APIが重要です。
- 用途に合わせてAPIを選ぶことで、運用と開発の効率を高められます。