WordPress REST API:それとは何か、それを使い始める方法

過去数年間にWordPressコミュニティで何か時間を過ごしたことがあれば、新しいREST APIへの参照を聞いたことがあるかもしれません。ただし、経験豊富な開発者でない限り、WordPress REST APIが実際に何であるかを理解できない場合があります。.


技術的な詳細は少し複雑ですが、この機能の背後にある基本的な概念は簡単に理解できます。新しいAPIは、プラットフォームとしてのWordPressの機能を拡張するのに役立ちます。さらに、REST APIにより、開発者はWordPressを他のサイトやアプリケーションと簡単に接続できるようになります.

WordPress REST API

この包括的なガイドでは、知っておく必要のあるすべての基本事項について説明します。一般的なAPIと、特にREST API(およびWordPress固有のバージョン)について説明します。次に、WordPress REST APIを自分で使い始める方法について説明します。すぐに飛び込もう!

アプリケーションプログラミングインターフェイス(API)の概要

REST APIについて詳しく説明する前に、少しバックアップしてみましょう。この概念を理解するには、まずAPIが一般的に何であるかについての基本的な考えを持っていることが重要です.

その最も基本的なレベルで, API –またはアプリケーションプログラミングインターフェイス – 2つのアプリケーションが相互に通信できるようにします。たとえば、ウェブサイトにアクセスすると、ブラウザはそのサイトが配置されているサーバーにリクエストを送信します。そのサーバーのAPIは、ブラウザーのリクエストを受信して​​解釈し、サイトの表示に必要なすべてのデータを送り返します。.

他にもたくさんあります APIの仕組み もちろん、技術的な意味で。ただし、ここでは、おそらく最も重要なもの、つまり実用的なアプリケーションに焦点を当てます。多くの企業がAPIをパッケージ化し、使用可能な製品として提供するようになったため、APIは多くの注目と可視性を得ています。.

つまり、Googleのような会社の開発者は、アプリケーションのコードの一部をまとめて収集し、 公開する. そうすることで、他の開発者は自分のサイトがGoogleに接続し、その機能を利用できるようにするためのツールとしてAPIを使用できます。

GoogleのAPIライブラリ。

たとえば、Google Maps APIを使用して 完全に機能するマップを配置する Googleのすべての関連データと機能の恩恵を受けるサイト。これにより、マップをコーディングしてすべてのデータを自分で収集する必要がなくなります。同じことが幅広いサイトとアプリケーションに適用されます.

Webサイトとそれらが依存する機能がより複雑になるにつれて、APIなどのツールが重要になります。開発者は既存の機能に基づいて構築できるため、新しい機能をWebサイトに「プラグイン」するだけで済みます。次に、APIを所有するサイトは、露出とトラフィックの増加から恩恵を受けます.

REST(Representational State Transfer)APIの基本的なルール

APIを作成するには多くの方法があります。あ REST(Representational State Transfer)API 特定のルールに従って開発された特定のタイプです。つまり、RESTは、開発者がAPIを構築するときに使用できる一連のガイドラインを提供します。これにより、APIが効果的に機能します.

したがって、REST APIがどのように機能するかを理解するには、REST APIが機能するルール(または「制約」)を知る必要があります。. がある 5つの基本要素 APIを「RESTful」にする. 「サーバー」はAPIが属するプラットフォームであり、「クライアント」はそのプラットフォームに接続するサイト、アプリケーション、またはソフトウェアであることに注意してください。

RESTful

  1. クライアントサーバーアーキテクチャ. APIは、クライアントとサーバーが互いに分離したままになるように構築する必要があります。そうすれば、彼らは自分で開発を続けることができ、独立して使用できます.
  2. 無国籍. REST APIは「ステートレス」プロトコルに従う必要があります。つまり、クライアントに関する情報をサーバーに保存することはできません。クライアントのリクエストには必要なすべてのデータを事前に含め、レスポンスにはクライアントが必要とするすべてのものを含める必要があります。これにより、各インタラクションが「1回で済む」取引になり、メモリ要件とエラーの可能性の両方が削減されます.
  3. キャッシュ可能性. 「キャッシュ」 特定のデータを一時的に保存するため、データの取得と送信を高速化できます。 RESTful APIは、可能な限りキャッシュ可能なデータを使用して、速度と効率を向上させます。さらに、APIは、各データをキャッシュできるかどうか、およびキャッシュする必要があるかどうかをクライアントに通知する必要があります。.
  4. 階層化システム. 適切に設計されたREST APIはレイヤーを使用して構築されており、各レイヤーには独自の指定された機能があります。これらの層は相互作用しますが、分離したままです。これにより、時間の経過とともにAPIを簡単に変更および更新でき、さらに セキュリティを向上させる.
  5. 均一なインターフェース. REST APIのすべての部分は、同じインターフェースを介して機能し、同じ言語を使用して通信する必要があります。このインターフェイスは、API専用に設計され、独自に進化できる必要があります。機能するためにサーバーやクライアントに依存するべきではありません.

これらの原則に従うAPIはすべてRESTfulと見なすことができます。 「コードオンデマンド」と呼ばれる6番目の制約もあります。従うと、この手法により、APIはサーバーに機能を拡張するためにコードをクライアントに送信するようサーバーに指示できます。ただし、この制約はオプションであり、すべてのREST APIで採用されているわけではありません.

WordPress REST API

この時点で、これらすべてがどのように影響するのか疑問に思われるかもしれません。 APIは優れたツールですが、日常業務に関連していますか?あなたがWordPressユーザーなら、答えは明白です "はい".

WordPress REST APIは数年前から開発中です。かなりの間、それは 独立したプラグイン, 開発者が時間をかけて貢献できるものは誰でも実験することができました.

実際、 2つの異なるバージョン REST APIプラグインの。 APIの要素は、アップデート4.4からコアプラットフォームに追加されました。その後、WordPress 4.7(2016年)から完全に統合されました。つまり、今日、WordPressには独自の完全に機能するREST APIがあります。.

なぜプラットフォームはこの動きをしたのですか?による プロジェクトサイト それ自体は、WordPressが "本格的なアプリケーションフレームワーク". つまり、REST APIを使用すると、プラットフォームはほぼすべてのサイトおよびWebアプリケーションと対話できます。さらに、外部プログラムが使用する言語に関係なく、データを通信および交換できます.

レストAPI

これは、開発者に多くの可能性を開きます。また、プラットフォームとしてのWordPressをこれまで以上に柔軟で普遍的なものにします。ケイティキースとして、 Barn2 Media それを置く:

WordPress開発者は、REST APIを理解することで、PHPやWordPressバックエンドなどの特定のテクノロジーやプラットフォームに限定されることなく、各タスクを実装する最も効果的な方法を選択できます。 REST APIを効果的に使用すると、サードパーティの統合がはるかに簡単になります。たとえば、独自のWordPressベースのモバイルアプリを作成したり、WordPressと通信するための新しくユニークな方法を模索したりするなど、新しい機会を切り開きます.

また、この機能がWordPress JSON REST APIと呼ばれることもあることに注意してください。. 「JSON」の部分, これはJavaScript Object Notationを表し、このAPIがデータを交換するために使用するフォーマットを説明しています。このフォーマットはJavaScriptに基づいており、多くの一般的なプログラミング言語とのインターフェースが優れているため、APIを開発する一般的な方法です。言い換えると、JSON APIは、異なる言語を利用するアプリケーション間の通信をより簡単に促進することができます.

WordPress REST APIリクエストの構造

WordPress REST APIの全体的な目的と方向性を理解する必要があります。そのため、それがどのように機能するかについて、いくつかの詳細を見ていきましょう。実践してAPIを自分で試したい場合に理解しておく必要がある基本的な概念がいくつかあります。.

説明したように、すべてのAPIがリクエストを処理し、レスポンスを返します。つまり、クライアントが特定のアクションを実行するように要求し、APIがそのアクションを実行します。 APIがこれをどのように行うかは、実際にはさまざまです。 REST APIは、単純なHTMLコマンド(または「メソッド」)を使用して、特定のタイプのリクエストを受信して​​応答するように特別に設計されています.

説明するために、ここに最もあります 基本的で重要なHTMLメソッド クライアントは以下を送信できます:

HTMLメソッド

  • 取得する: このコマンドは、サーバーからリソース(特定のデータなど)を取得します.
  • 役職: これにより、クライアントはサーバーにリソースを追加します.
  • プット: これを使用して、すでにサーバー上にあるリソースを編集または更新できます.
  • 削除: 名前が示すように、これはサーバーからリソースを削除します.

これらのコマンドに加えて、クライアントは、必要なリソースとそのリソースで実行する必要があることを正確に伝える1つ以上の行を送信します。たとえば、サーバー上の特定のフォルダにPHPファイルをアップロードするリクエストは次のようになります。

POST /foldername/my_file.php

/foldername/my_file.phpの部分は 「ルート」と呼ばれる, APIに移動先とやり取りするデータを指示するからです。これをHTTPメソッド(この場合はPOST)と組み合わせると、関数全体が「エンドポイント」と呼ばれます。.

ほとんどのREST APIおよびそれらとやり取りするクライアントは、WordPressバージョンが含まれているため、これよりもはるかに複雑になります。ただし、これらの基本的な要素は、WordPress REST APIが機能する方法の基礎を形成します.

WordPress REST APIの使用を開始する方法

WordPressサイトが設定されている限り、REST APIをすぐに試すことができます。ブラウザを使用するだけで、さまざまなGETリクエストを実行してデータを直接取得できます.

WordPress REST APIにアクセスするには、次のルートから始める必要があります。

yoursite.com/wp-json/wp/v2

次に、このURLに追加して、さまざまなタイプのデータにアクセスできます。たとえば、次のようなルートを介して特定のユーザープロファイルを検索できます。

yoursite.com/wp-json/wp/v2/users/4567

このシナリオでは, "4567" 表示するプロファイルの一意のユーザーIDです。そのIDを省略した場合は、サイト上のすべてのユーザーのリストが表示されます。

WordPress REST APIのユーザーのリスト。

同じ基本ルートを使用して、投稿やページなどの他のタイプのデータを表示できます。特定の条件を満たすデータのサブセットを検索することもできます。たとえば、次のURLを使用して、特定の用語を含むすべての投稿を取得できます。

yoursite.com/wp-json/wp/v2/posts?=search[keyword]

もちろん、これは単純なイラストです。 WordPress REST APIを使用して実際にできることにはほとんど制限がありません。それがどのように機能するかについてさらに知りたい場合は、以下のリソースから始めることをお勧めします。

WordPress REST APIは間違いなく複雑なトピックです。ただし、非開発者であっても、このテクノロジーがどのように機能し、何が可能になるのかについての基本を理解することは価値があります。さらに、自分で開発を少しでも始めることができるかもしれません。!

WordPress REST APIを使用するもう1つの方法

WordPress REST APIは、多くの興味深いものやプロジェクトに使用できます。私たちはそれをかなり明確に確立しました.

ただし、本当の人気を得ている分野が1つあります。

ヘッドレスワードプレス WordPressエコシステムの2つの主要なレイヤー(バックエンドとフロントエンド)を分離するという考え方です.

これにより、WordPressソフトウェアの内部にあるすべての利点を利用して、標準のWordPressプレゼンテーションを使用しない最終製品と接続することができます。それは、それ自体がWebサイトではありません。.

全体のコンセプトはとても面白いです。ヘッドレスワードプレスが理にかなっているかどうかを議論し、市場でトップのヘッドレスワードプレスホスティングソリューションを比較する別の投稿で、それについてもう少し説明します.

結論

WordPress REST APIについて学ぶのに今ほど良い時間はありません。 WordPressコアに完全に統合されているため、プラットフォームの将来において重要な役割を果たすことになります。すべてのストライプの開発者は、このAPIを使用して、以前は困難または不可能であった方法でWordPressをより幅広いWebに接続します。.

この概念を自分で理解することは、少し難しいかもしれません。ただし、基本的なレベルでは、概念を理解するのは簡単です。 REST APIは、2つのプログラムが互いに「対話」できるようにするインターフェースであり、作成されます 次のガイドライン 柔軟性、拡張性、安全性を保証します。これらすべてがどのように機能し、どのように使用できるかについてさらに詳しく知りたい場合は、公式などの役立つリソースがたくさんあります ハンドブック.

REST APIについて質問がありますか?それはWordPressにとって何を意味しますか?下のコメント欄でお問い合わせください!

WordPressサイトの高速化に関する速習コースに参加することを忘れないでください。いくつかの簡単な修正により、ロード時間を50〜80%も短縮できます。

Jeffrey Wilson Administrator
Sorry! The Author has not filled his profile.
follow me
    Like this post? Please share to your friends:
    Adblock
    detector
    map