WordPress REST API を理解する：開発者向けガイド

イントロ

ウェブサイトの作成は複雑で多段階のプロセスです。それを始めるには、まず質の高いホスティングソリューションを見つける必要があります。あなたが新しいウェブサイトを作成しようとしており、リソースのための非常に高い需要と予想される非常に高いトラフィックを持っていない場合は、VPSサーバーは、ほとんどのウェブサイトに適しています汎用性の高いソリューションです。支払い方法が重要な場合は、クレジットカードVPS、ビットコインVPS、AliPay VPSなど、さまざまなオプションの中から選択できることを知っておく必要があります。

ウェブサイトを作成するもう一つの基本的な側面は、CMSの 選択です - コンテンツ管理システム、コンテンツでウェブサイトを埋め、それを変更するために使用される特別なツールです。WordPressを選択した場合、開発者はWordPress REST APIを扱わなければなりません。

Wordpressは、現在ウェブサイトを構築するための最も人気のあるCMSの一つです。REST APIは、Wordpressのウェブサイトを操作するために不可欠なインターフェースです。REST APIにより、アプリケーションはJSONファイルを通してウェブサイトとやり取りすることができます。このようにして、開発者はWordpressの上にカスタムアプリケーション、ウェブサイト、プラグインを構築することができます。REST API により、開発者は HTTP コマンドによって Wordpress のデータとやり取りすることができます。

以下では、どんな開発者にとっても役に立つ、いくつかの重要なコマンドを紹介しよう。

WordPress REST API：エッセンシャル

GET：

HTTP GETメソッドを使用してWordPressデータベースからデータを取得するために使用します。このコマンドは最も一般的なコマンドのひとつで、実際にデータを操作する前に使用する最初のコマンドです。

投稿、ページ、カスタム投稿タイプなど、特定のリソースを変更せずに取得することができます。

このメソッドを使用するには、特定のエンドポイントに指定されたパラメータセットでリクエストを送信する必要があります。例えば、リソースのID、フィルタリングオプション、ページネーション情報、その他のクエリパラメータなどです。

これを打てば

http://yoursite.com/wp-json/wp/v2/posts/983

をクリックすると、タイトル、コンテンツ、著者、その他のメタデータなど、この特定のIDを持つ投稿の詳細が表示されます。

さらに、リソースのリストの情報を取得することもできます。例えば、すべての公開済みリソースを見たい場合は、/wp/v2/posts?status=publishをエンドポイントリクエストに追加します：

http://yoursite.com/wp-json/wp/v2/posts?status=publish

ポスト：

このコマンドは、ウェブサイトに何か新しいものを追加するときに使います。これは実際には投稿ですが、ページ、コメント、その他の添付ファイルにも使用できます。

新しい投稿を作成するには、エンドポイントに/wp/v2/postsを追加する。

POST http://yoursite.com/wp-json/wp/v2/posts

そしてペイロードに、タイトル、コンテンツ、著者、その他のメタデータなど、新しい投稿のデータを含めることができる：

"title": "私の新しい投稿", "content": "これは私の新しい投稿の内容です", "author"：1, "status": "公開"

プットする：

POSTは、ページや投稿に空の下書きを作成するために使われます。さらに新しい内容で更新するには、PUTコマンドを使います。これはさらに、以前に作成した下書きを公開するためにも使用できます。

現在のすべての原稿を見るには、このようにPOSTコマンドを使うことができる：

POST http://yoursite.com/wp-json/wp/v2/posts/?status="draft".

この後、PUTコマンドを使ってIDを入力すれば、特定のドラフトのステータスを変更することができる：

PUT http://yoursite.com/wp-json/wp/v2/posts/983

投稿を修正するオプションが表示されます。投稿のステータスを "下書き "から "公開 "に切り替えてください：

"status" = "publish"

さらに、"status "引数を使ってさらに内容を追加することもできる：

"status" = "publish" "content" = "内容はこちら"

削除する：

投稿、ページ、コンテンツ、ユーザーの削除に使われる、もうひとつの重要なコマンド。削除された投稿はまずゴミ箱に入れられる。

特定の投稿、たとえば上で作成した投稿を削除するには、次のように入力する：

DELETE http://yoursite.com/wp-json/wp/v2/posts/983

投稿をゴミ箱に入れずに永久に削除したい場合は、?force=trueを後ろに追加してください：

DELETE http://yoursite.com/wp-json/wp/v2/posts/983?force=true

オプション：

あるリソースで利用可能な通信オプションを調べたい場合、このコマンドを使うことができます。このコマンドを入力すると、特定のリソースで利用可能な通信方法のリストと、サポートされている認証方式、リクエストヘッダ、コンテンツタイプなどの関連情報が出力されます。

頭：

このコマンドは、実際のコンテンツに関係なく、コンテンツのヘッダーを取得することができる。このようにして、開発者はコンテンツの一部について、キャッシュ情報、コンテンツタイプ、コンテンツの長さなどの必要な情報を、ダウンロードすることなく得ることができます。

パッチ

このコマンドを使うと、コンテンツの特定の部分を更新することができます。PUTと多少似ていますが、特定のリソースを完全に置き換える必要はありません。この方法では、投稿のタイトルや内容、ユーザーに関連付けられたメタデータを更新することができます。

コマンドを使用する際には、どの変更を行いたいかを指定する必要があります。例えば、タイトルを編集するには、リクエストボディにこれを追加する必要があります：

"title": "新しい投稿タイトル"

結論

WordPress REST APIは、アプリケーションがWordPressサイトとやりとりするための多機能インターフェースです。このインターフェイスは、さまざまなコマンドの助けを借りて管理されます。この情報がお役に立てば幸いです！