WordPress REST API の使い方完全ガイド

更新日
2025年7月21日

[aioseo_eeat_author_tooltip]

[aioseo_eeat_reviewer_tooltip]

絶えず進化を続けるウェブ開発、異なるシステムがシームレスに通信できることが極めて重要です。そこで登場するのが、アプリケーション・プログラミング・インターフェース（API）です。APIは、異なるテクノロジー間の重要な架け橋として機能します。世界で最も人気のあるコンテンツ管理システム、その強力なAPIであるWordPress REST APIが、開発者がWordPressのデータとやり取りし、最新のウェブアプリケーションを構築する方法に革命をもたらしました。

この包括的なガイドでは、WordPress REST API の基本概念から高度な統合までを解説し、 WordPressサイトの潜在能力を最大限に引き出すことができるようになります。

コンテンツ

REST APIでWordPressの潜在能力を解き放つ

アプリケーションプログラミングインターフェース（API）とは、本質的に、異なるWebシステム間の通信とデータ交換を可能にする一連のルールとプロトコルです。レストランのメニューのようなものだと考えてみてください。厨房がどのように料理を調理するかを知る必要はありません。何を注文できるか、そしてどのように注文するかさえ知っていれば十分です。APIは、ソフトウェアコンポーネントにとってまさに「メニュー」のような役割を果たします。.

WordPress REST APIは、ネットワークリソースとのやり取りにおける統一インターフェースを定義するソフトウェアアーキテクチャスタイルであるRepresentational State Transfer (REST) の原則に準拠しています。RESTfulの主要な原則には、クライアントサーバーアーキテクチャ、ステートレス性、キャッシュ可能性、階層化システムなどがあります。この標準化されたアプローチは、データ交換において非常に柔軟かつ堅牢です。.

WordPress REST APIは、構造化され、予測可能で、堅牢なコンテンツ操作方法を提供します。ブロックエディター（Gutenberg）などの最新機能の基盤として、このAPIはヘッドレスWordPressアーキテクチャを容易に実現します。さらに、WordPressデータへのアクセスにおいて、admin-ajaxなどの時代遅れの手法に代わる、より一貫性があり現代的な代替手段を提供します。

WordPress REST API 統合に関するサポートが必要ですか?

カスタム API エンドポイントから本格的なヘッドレスビルドまで、Seahawk Media の WordPress エキスパートは、強力で安全な統合によりお客様のビジョンを実現します。.

お問い合わせ！

WordPress REST APIの基礎：はじめに

WordPress REST API の優れた点は、基本的なやり取りがシンプルであることです。データの送受信にはJavaScript Object Notation

ルートとエンドポイントの理解

API経由でアクセスできるすべてのWordPressデータは、エンドポイントと呼ばれる特定のURLを通じて公開されます。エンドポイントはルートに整理されています。WordPress REST APIのベースURLは通常、yourdomain.com/wp-json/になります。.

そこから、一般的な WordPress コンテンツのデフォルトの名前空間とエンドポイントを見つけることができます。

/wp/v2/posts エンドポイントを使用すると、ブログ投稿データを取得および管理できます。.
/wp/v2/pages ルートを使用して、Web サイトのページにアクセスしたり更新したりします。.
/wp/v2/users エンドポイントを通じてユーザー関連の情報を管理できます。.
/wp/v2/categories、/wp/v2/tags、/wp/v2/media などのエンドポイントは、カテゴリ、タグ、メディア、その他のコンテンツタイプなどのアセットを処理するために使用できます。.

例えば、最新の投稿リストを取得するには、通常、yourdomain.com/wp-json/wp/v2/posts にAPIリクエストを送信します。IDが123の単一の投稿の特定のデータを取得するには、エンドポイントは yourdomain.com/wp-json/wp/v2/posts/123 になります。.

こちらもご覧ください: WordPressにサードパーティAPIを統合する方法

WordPressデータとやりとりするためのHTTPメソッド（動詞）

APIは標準的なHTTPメソッドと動詞を使用して、WordPressデータに対して様々なアクションを実行します。各HTTPメソッドは特定の操作の種類に対応しています。

GET (データの取得/取得):これは最も一般的なメソッドです。WordPressデータベースからデータを取得するために使用します。例えば、/wp-json/wp/v2/postsへのGETリクエストは投稿のリストを返します。これがデータの取得を開始する方法です。

POST（新規データの作成）： WordPressサイトに新しいコンテンツを作成するには、POSTメソッドを使用します。例えば、適切なJSONデータを含むPOSTリクエストを/wp-json/wp/v2/postsに送信すると、新しい投稿が作成されます。

PUT/PATCH (既存データの更新):これらのメソッドはWordPressデータを変更します。PUTは通常、リソースの完全な置き換えに使用され、PATCHは部分的な更新に使用されます。PUTまたはPATCHリクエストは、/wp-json/wp/v2/posts/{id}などの特定のエンドポイントに送信します。

DELETE（データ削除）：名前の通り、DELETE HTTPメソッドはWordPressインストールからリソースを削除します。例えば、/wp-json/wp/v2/posts/{id}へのDELETEリクエストは、そのIDの投稿を削除します。

さらに詳しく: WordPressインタラクティビティAPIをマスターする

JSON データの操作 (JavaScript オブジェクト表記)

APIリクエスト、特にGETリクエストを行うと、WordPress REST APIはJSON形式で情報を返します。JSONは軽量なデータ交換フォーマットで、人間が読み書きしやすく、機械が解析・生成するのも簡単です。WordPress REST APIから送信されるすべての生データは、このフォーマットになります。.

たとえば、単一の投稿に対する JSON データ応答は次のようになります。

{ "id": 1, "date": "2023-10-26T10:00:00", "title": { "rendered": "私の最初のブログ投稿" }, "content": { "rendered": "<p>これが私の最初の投稿の内容です。</p> " }, "status": "publish", "type": "post", "link": "http://yourdomain.com/my-first-blog-post/", // ... 詳細なデータ }

この JSON 形式を理解することは、応答を解析し、カスタムアプリケーションまたはプロジェクトでデータを使用するための鍵となります。.

最初のAPIリクエストの作成

今すぐ WordPress REST API の探索を開始できます。.

ブラウザを使用する場合：ウェブブラウザを開き、yourdomain.com/wp-json/ にアクセスしてください。JSON形式で利用可能なルートとエンドポイントのリストが表示されます。次に、yourdomain.com/wp-json/wp/v2/posts にアクセスして、サイトのコンテンツのリストを確認してください。これは、シンプルなブラウザリクエストでデータ（公開データ）を取得する方法を示しています。

コマンドライン (コマンドプロンプト/ターミナル) の使用:よりプログラム的なアプローチとして、コマンドプロンプトまたはターミナルで curl を使用できます。

curl http://yourdomain.com/wp-json/wp/v2/posts

データを取得するためのこの curl post コマンドは、同じ JSON WP v2 投稿データを取得します。.

Postmanなどのツールの利用：より複雑なHTTPリクエスト（特にPOST、PUT、DELETE）の場合、PostmanやInsomniaなどのツールは、APIリクエストの構築とテストのためのユーザーフレンドリーなインターフェースを提供します。これらのツールは開発プロセスにおいて非常に役立ちます。

認証と承認：WordPress REST APIのセキュリティ保護

WordPress REST APIはデフォルトで公開データ（公開済みの投稿や固定ページなど）へのアクセスを許可していますが、WordPressデータの変更（作成、更新、削除）やプライベートデータ（下書き、非公開投稿、ユーザー情報）へのアクセスには認証が必要です。これは、WordPressデータベースを保護し、WordPressウェブサイトのセキュリティを維持するために不可欠です。.

認証が重要な理由

認証は、APIリクエストを発行するユーザーまたはアプリケーションの身元を検証します。一方、認可は、認証されたユーザーまたはアプリケーションが実行できる操作を決定します。適切な認証が行われないと、誰でもサイトのコンテンツを操作でき、深刻なセキュリティ侵害につながり、WordPressインストールが破損する可能性があります。.

一般的な認証方法

WordPress REST API では、ユースケースに応じていくつかの認証方法を提供しています。

Cookie認証：これはWordPressバックエンドで使用されるデフォルトの認証方法です。WordPressサイトにログインすると、ブラウザにCookieが保存され、ログインユーザーとしてAPIエンドポイントとやり取りできるようになります。この認証方法は、ユーザーがWordPressサイトと直接やり取りするWordPressバックエンド内で実行されるテーマやプラグインに適しています。

アプリケーションパスワード： WordPress 5.6で導入されたアプリケーションパスワードは、外部のブラウザ以外のアプリケーション（モバイルアプリやサードパーティ製サービスなど）がWordPressサイトで認証を行う際に推奨される方法です。WordPressバックエンドのユーザープロフィールから、特定のアプリケーションごとに一意かつ取り消し可能なパスワードを直接生成できます。この方法では、ユーザーのメインパスワードが漏洩することはありません。

Basic認証（開発/特定のケース向け）： Basic認証方式では、各HTTPリクエストでユーザー名とパスワード（Base64エンコード）を送信します。実装は簡単ですが、セキュリティが低いため、厳格なHTTPS適用のない本番サイトには一般的に推奨されません。ローカル開発や特定の社内ツールでの使用が考えられます。SSHアクセスを使用しない場合は、WordPress REST APIでBasic認証を完全にサポートするにはプラグインが必要になる場合があります。

OAuth 1.0a / OAuth 2.0: OAuthは、サードパーティサービス、特にユーザーの同意を必要とするサービス（ソーシャルメディアログインなど）とのより堅牢で安全な統合を実現する、より安全で標準化されたフレームワークを提供します。WordPress REST APIは当初OAuth 1.0aをサポートしていましたが、最近の実装ではプラグインやカスタムソリューションを介してOAuth 2.0が採用されることが多くなっています。

JWT（JSON Web Token）：特にヘッドレスCMS環境で人気が高まっているJWTは、二者間で転送されるクレームを表現するためのコンパクトでURLセーフな手段です。カスタムシングルページアプリケーション（SPA）やモバイルアプリの構築時によく使用され、初回ログイン後のステートレス認証を可能にします。

ユーザーの役割と権限

WordPress REST APIは、WordPressに組み込まれたユーザーロールと権限システムを尊重します。例えば、購読ユーザーはWordPressバックエンドから投稿を削除できないのと同様に、API経由で投稿を削除することはできません。この準拠により、データアクセス方法に関わらず、認可ルールが一貫して適用されます。カスタムアプリケーションを構築する際は、常に最小権限の原則を適用し、必要な権限のみを付与してください。.

WordPress REST API のセキュリティに関するベストプラクティス

ライブサイトで WordPress REST API を使用する場合、セキュリティが最も重要です。

常に HTTPS を使用する:機密データが傍受されるのを防ぐために、すべての HTTP リクエストを暗号化します。

入力の検証とサニタイズ: API に送信される新しいデータや更新されたデータは、インジェクション攻撃を防ぐために、サーバー側で厳密に検証およびサニタイズされる必要があります。

レート制限を実装する:特定の時間枠内で単一の IP またはユーザーが実行できる API リクエストの数を制限することで、WordPress サイトをブルートフォース攻撃から保護し、サーバーの過負荷を防止します。

ファイアウォールと IP ホワイトリスト: Web アプリケーションファイアウォール (WAF) を使用し、必要に応じて API アクセスを特定の IP アドレスに制限します。

定期的な更新: WordPress のインストール、テーマ、プラグインを更新して

高度な使用法: WordPress REST API の拡張と最適化

一度基礎を理解すれば、WordPress REST API の高度な機能により、WordPress 開発の無限の可能性が広がります。.

クエリパラメータの操作

データを取得する際に、クエリパラメータを使用すると、結果のフィルタリング、並べ替え、ページ区切りが可能になり、取得するデータをきめ細かく制御できます。これらのパラメータは、エンドポイントURLの末尾に「?」を付けて追加します（複数のパラメータを指定する場合は「&」で区切ります）。

ページネーション: ?per_page=10&page=2 (2 ページ目から 10 個の項目を取得します)。
カテゴリー/タグによるフィルタリング: ?categories=123 (ID 別) または ?category_slug=technology (スラッグ別)。
投稿ステータスによるフィルタリング: ?status=draft (認証が必要です)。
検索: ?search=キーワード
並べ替え: ?orderby=date&order=asc
特定のフィールドの選択（_fieldsパラメータ）：これはパフォーマンス向上に不可欠です。リソースのすべての生データを取得する代わりに、必要なフィールドのみを指定できるため、サーバーの負荷が軽減され、データ取得速度が向上します。例えば、wp-json/wp/v2/posts?_fields=id,title,link のように指定します。

カスタムエンドポイント: WordPress REST API の拡張

デフォルトのエンドポイントは強力ですが、標準APIではカバーされていない特定のデータを公開したり、独自のアクションを実行したりする必要がある場合があります。このような場合、カスタムエンドポイントの作成が非常に重要になります。WordPress REST APIの機能を拡張することで、カスタム投稿タイプやカスタムフィールド（メタデータ）を取得・操作したり、カスタムアプリケーションロジックを統合したりできます。.

カスタムREST APIルートは、テーマのfunctions.phpファイルまたはカスタムプラグイン内のregister_rest_route()関数を使用して登録します。この関数は、エンドポイントのパス、レスポンスの対象となるHTTPメソッド（GET、POST、PUT、DELETE）、そしてエンドポイントにアクセスした際に実行されるコールバック関数を定義します。.

以下に単純化した例を示します。

add_action( 'rest_api_init', 関数() { register_rest_route( 'myplugin/v1', '/custom-data/(?P<id> \d+)', array( 'methods' => 'GET', 'callback' => 'get_custom_data_by_id', 'permission_callback' => '__return_true' // 公開データの場合は、非公開データに対して適切な認証が行われていることを確認してください。 ) ); } ); function get_custom_data_by_id( $request ) { $post_id = $request['id']; // $post_id に基づいて WordPress データベースからデータを取得します $post = get_post( $post_id ); if ( ! empty( $post ) ) { return new WP_REST_Response( $post, 200 ); } else { return new WP_Error( 'no_data', 'カスタムデータが見つかりません', array( 'status' => 404 ) ); } }

これにより、コンテンツをプッシュしたり、カスタムアプリケーションに合わせてカスタマイズされた非常に具体的な情報をプルしたりするための wp api ルートを作成できます。.

WordPressと外部システムおよびモバイルアプリの統合

WordPress REST API は、従来の WordPress バックエンドを超越する無数の実際のアプリケーションのバックボーンです。.

ヘッドレスCMS

これは、現実世界でもっとも革新的なアプリケーションの一つです。ヘッドレスCMSのセットアップでは、WordPressはサイトのコンテンツを保存・管理するコンテンツ管理システムとして機能します。同時に、独立したフロントエンド（React、Vue、Angularなどの最新のJavaScriptフレームワークで構築）がREST API経由でWordPressのデータを利用します。

メリット：フロントエンドの柔軟性が大幅に向上し、パフォーマンスが向上し（サーバー負荷が軽減されます）、複数のチャネル（モバイルアプリ、スマートディスプレイ、Apple Newsなど）にコンテンツを公開できるようになります。コンテンツ管理とプレゼンテーション層が分離されます。

モバイルアプリ

WordPress REST APIは、モバイルアプリ（iOSおよびAndroid）がデータを取得し、WordPressコンテンツを表示し、ユーザーがコンテンツを作成または更新するための標準化された方法を提供します。既存のWordPressウェブサイトを活用し、モバイルエクスペリエンス

カスタムアプリケーション開発

WordPressと連携するカスタムソリューションを構築します。これには、独自の内部ダッシュボード、専用のコンテンツ表示システム、他のビジネスツールとの統合などが含まれます。.

サードパーティサービスの統合

WordPressのデータをCRM 、マーケティングオートメーションプラットフォーム、eコマース、その他のウェブシステムとシームレスに統合します。例えば、postメソッドを使用して、外部のコンテンツ作成ツールからWordPressに新しい投稿を自動的に作成できます。

タスクの自動化

APIリクエストを使用して、投稿タイプの一括更新、複数サイトにわたるコンテンツシンジケーション、レポート生成などのタスクを自動化できます。WP CLIなどのツールは、REST APIと直接または間接的に連携し、SSHアクセスを介して高度な自動化を実現できます。.

WordPress REST API のパフォーマンス最適化

効率的な WordPress 開発には、API パフォーマンスを最適化してサーバーの負荷を軽減し、ユーザーエクスペリエンスを向上させることが含まれます。.

効率的なAPI呼び出し： _fieldsクエリパラメータを使用して、必要な特定のデータのみを取得します。不要な生データの送信やリクエストは避けてください。

キャッシュを活用する:さまざまなレベルでキャッシュを実装します

オブジェクトキャッシュ: WordPress バックエンド用。
一時 API:特定の API 応答を WordPress 自体にキャッシュします。
ブラウザキャッシュ:静的 API 応答に適切な HTTP ヘッダーを構成します。
リバースプロキシキャッシュ (例: Varnish、Nginx FastCGI Cache):トラフィック量の多いライブサイト向け。

ページ区切り: 1 回の API リクエストで返されるアイテムの数を制限するには、常に per_page および page パラメータを使用し、サーバーに負担をかける可能性のある巨大な JSON データ応答を防止します。

データベースクエリの最適化:カスタムエンドポイントのコールバック関数が WordPress データベースに対して最適化されたクエリを実行し、効率的なデータアクセスを実現するようにします。

外部 HTTP リクエストを最小限に抑える: API 呼び出しが外部サービスに依存している場合は、それらの実行方法とタイミングを最適化します。

よくある WordPress REST API の問題のトラブルシューティング

綿密な計画を立てていても、開発プロセス中に問題が発生する可能性があります。よくある問題とトラブルシューティングのヒントをご紹介します。

HTTP ステータスコード: API リクエスト応答で返される HTTP ステータスコードに注意してください。

200 OK: 成功。.
400 不正なリクエスト: リクエストの形式が正しくありません。.
401 権限がありません: 認証が必要です、または資格情報が見つからないか無効です。.
403 禁止: 認証されましたが、権限がありません (例: ユーザーロールが間違っている、または特定の投稿タイプに対する DELETE 操作の強制引数がありません)。.
404 見つかりません: エンドポイントが存在せず、リソースが見つかりませんでした。.
500 内部サーバーエラー: サーバー側で問題が発生しました。サーバーログを確認してください。.

CORS（クロスオリジンリソース共有）の問題： WordPressサイトとは異なるドメインでJavaScriptフロントエンドを構築している場合、CORSエラーが発生する可能性があります。フロントエンドドメインからのクロスオリジンリクエストを許可するようにサーバーを設定するか、WordPressプラグインを使用する必要があります。

デバッグ：ブラウザの開発者ツール（ネットワークタブ）を使用して、APIリクエストとレスポンスを調べてください。Postmanなどのツールは詳細なエラーメッセージを提供します。WordPressにはデバッグモードがあり、より詳細なエラー出力を取得できます。

実際のアプリケーションとユースケース

WordPress REST API の汎用性により、多様で革新的なシナリオで採用されるようになりました。

ブロックエディター（Gutenberg）： WordPressのコア機能であるこの機能は、その好例です。エディター内でのブロック操作、保存、コンテンツ操作はすべてWordPress REST APIによって実行されます。REST APIはデータを取得し、投稿HTTPリクエストを使用してWordPressデータベース内のコンテンツを更新します。

WordPress.com の Calypso インターフェース: WordPress.com のデスクトップアプリケーションは、API を使用してサイトを管理し、堅牢な外部ユーザーインターフェースの機能を実証します。

コンテンツシンジケーション:メディア組織は、WordPress REST API を使用して、Apple News やカスタムニュースアグリゲータなどのさまざまなプラットフォームにコンテンツをプッシュします。

シングルページアプリケーション (SPA):フロントエンドがレンダリングを処理し、WordPress が API 経由で JSON データを提供するだけの、動的でインタラクティブな Web エクスペリエンスを構築します。

電子商取引の統合:人気の WordPress 電子商取引プラグインである WooCommerce は、REST API エンドポイントを広範に使用して、製品管理、注文処理、支払いゲートウェイおよび配送サービスとの統合を容易にします。

カスタム管理ダッシュボード：クライアントや社内チーム向けに、必要なWordPressデータのみを表示する、シンプルまたは高度に特化したダッシュボードを作成できます。APIデータを使用してカスタム投稿タイプから位置情報をプロットするGoogleマップ連携を想像してみてください。

結論: WordPress開発の未来

WordPress REST APIは単なる機能ではありません。WordPress開発へのアプローチを根本的に変えるものです。WordPressを従来のモノリシックなコンテンツ管理システムから、あらゆるデジタルエクスペリエンスを支える強力で柔軟なデータアクセスレイヤーへと変貌させます。.

モバイルアプリの開発、サードパーティサービスとの統合、ヘッドレスCMSプロジェクトの立ち上げなど、WordPress REST APIの習得は必須スキルです。WordPressデータとシームレスに連携することで、高度にカスタマイズされ、パフォーマンスに優れ、将来性も考慮されたWebアプリケーションを構築できます。.

次のプロジェクトで WordPress REST API を活用し、WordPress サイトの新たな可能性を広げましょう。

WordPress REST APIに関するよくある質問

WordPress REST API とは何ですか?

WordPress REST APIは、外部アプリケーションやウェブシステムがWordPressサイトと連携できるようにするアプリケーションプログラミングインターフェースです。これにより、HTTPリクエストとJSONデータを使用して、WordPressデータ（投稿、ページ、ユーザーなど）を標準化された方法で取得、作成、更新、削除できます。.

WordPress REST API を使用するにはどうすればよいですか?

WordPress REST API を使用するには、WordPress サイトの特定のエンドポイント（例：yourdomain.com/wp-json/wp/v2/posts）に HTTP リクエスト（GET、POST、PUT、DELETE）を送信します。API は通常 JSON 形式のデータで応答し、カスタムアプリケーションまたはウェブサイトで処理します。.

WordPress REST API を使用する利点は何ですか?

メリットとしては、フロントエンドとバックエンドの分離 (ヘッドレス CMS)、モバイルアプリの強化、WordPress とサードパーティサービスの統合、カスタムアプリケーションの構築、特定のデータの取得によるパフォーマンスの向上、WordPress 開発の全体的な柔軟性の向上などが挙げられます。.

WordPress REST API の一般的な問題をトラブルシューティングするにはどうすればよいですか?

よくある問題には、認証エラー（401/403）、エンドポイントが見つからない（404）、サーバーエラー（500）などがあります。トラブルシューティングには、HTTPステータスコードの確認、認証方法と資格情報の検証、ブラウザ開発者ツールやPostmanなどのツールでのAPIリクエストとレスポンスの検査、サーバーエラーログの確認などが含まれます。.