WordPress API 基礎知識:它的含義以及如何使用它

已發表: 2016-03-03

您可能聽說過有關 WordPress JSON REST API 的嗡嗡聲。 這對 WordPress 用戶來說是個大新聞,值得慶祝!

JSON、REST、API——這是一個名字的很多行話,但是,讓我們把它分解一下。

什麼是 API?

API 代表“應用程序編程接口”,它是一組編程指令和標準,用於訪問基於 Web 的軟件應用程序或 Web 工具。 想像一下正在給出“軟件二”指令的“軟件一”。 API 是兩者之間的協議,並且通信線路是開放的。 基本上,他們對彼此所說的內容類似於“當你給我指示時,我將執行操作,或者返回正確的信息”。

當我們搜索網絡並使用各種軟件解決方案時,我們習慣於使用具有特定佈局、按鈕和圖形的用戶界面,我們與之交互以完成我們想要的任務。 所有這些對機器來說都是無用的,因為他們關心的只是數據、他們需要做什麼以及他們如何與之交互。 API 是軟件對“用戶界面”的替代,它為第二個軟件提供有關如何獲取數據和其他特定任務的說明。 它們對於使用 Web 應用程序的用戶來說是完全不可見的,並且只是一個軟件到軟件的接口。

wordpress-api-軟件到軟件

API 示例

在開發 Web 應用程序時,能夠訪問 API 非常棒。 當 API 向公眾發佈時,這意味著開發人員創建了由軟件服務提供支持的解決方案。 通常,它們消除了為許多任務重新發明輪子的需要,因為它們已經被創建了。

API 的一個很好的例子是亞馬遜。 亞馬遜發布了其 API,以便開發人員可以輕鬆訪問產品及其信息。 訪問它可以很容易地在亞馬遜上發布產品鏈接,更新價格和購買選項。

API 交互的另一個例子是音樂會門票購買。 要正式購票,您需要輸入您的信用卡信息。 API 用於將您的信用卡信息發送到遠程應用程序,然後該應用程序驗證信用卡信息是否正確。 一切檢查完畢後,遠程應用程序會向票務網站發迴響應,表示可以繼續,此時您已成功購買了票。 當這一切發生時,你只看到一個界面,那就是票務網站。 這是一個無縫的過程; 在幕後,許多應用程序使用 API 協同工作,但您作為用戶不會注意到任務何時從一個應用程序傳遞到另一個應用程序。

API 和 WordPress

亞馬遜和購票是 API 如何協同工作的絕佳示例,但這如何適用於 WordPress?
好吧,所有相同的想法都適用。 使用 WordPress API,您可以從 WordPress 中推送和拉取數據。

API 是一個關鍵工具,開發人員可以使用它輕鬆地將數據從他們的 WordPress 網站共享到其他網站或應用程序。 具體來說,此 API 允許您對 WordPress 內容執行createreadupdatedelete (CRUD) 操作。 內容類型的一些示例是:

  • 帖子
  • 自定義帖子類型
  • 頁面
  • 分類法
  • 用戶
  • 媒體

REST 是什麼意思?

這裡沒有打盹或打鼾,但 REST 指的是 API 的架構風格。 REST 代表具象狀態轉移。 還記得我們如何提到 API 提供了通信的細節,以便程序可以相互通信嗎? REST API 的設計方式使其提供了一種輕量級的通信方法,從而節省了帶寬。 WordPress JSON REST API 就是這樣做的,當有大量數據時,它是一個很好的選擇。

我們剛剛觸及了 REST 的皮毛; 如果您想了解更多信息,請查看此 REST 有用的教程。

JSON格式

要訪問數據,我們需要一個可以從中提取的源。 這就是 JSON 的用武之地。JSON 代表 JavaScript 對象表示法。 JSON 對於人類和機器來說都很容易閱讀和理解。 這是以有組織、易於訪問的方式存儲信息的完美方式。 由於 JSON 訪問起來非常簡單,因此非常適合創建 REST API,並且是 WordPress JSON REST API 的完美解決方案。

以下是 JSON 格式的基本概念:

{"employees":[
	{"firstName":"Jane", "lastName":"Smith"},
	{"firstName":"Anna", "lastName":"Olsen"},
	{"firstName":"Josh", "lastName":"Jones"}
]}

WordPress 中的 JSON 格式

JSON 不只是自己編寫,但不用擔心,您不必手動創建 JSON 文件。 有一個很棒的插件可以為您創建它。 使用此工具,網站的數據將採用正確的格式,包括用戶、帖子、頁面、分類等。 該插件可以在這裡找到。 此外,還有一些有用的文檔,在您開始使用時會很有價值。

wordpress-api

使用 JSON REST API

使用 API 是不言自明的; 您將以簡單的 JSON 格式獲取您網站的數據。 如果您安裝了插件,您可以嘗試以數據形式查看您網站的帖子。

檢索或更新數據就像發送 HTTP 請求一樣簡單。 HTTP 是一種請求/響應協議。 首先,您發送數據請求,然後將數據作為響應發回。

獲取方法

GET 方法用於檢索信息,對數據沒有影響。 只需向/wp-json/wp/v2/posts發送 GET 請求。 想搜索什麼? 例如,如果您正在搜索“開發”,您將通過 GET 請求/wp-json/wp/v2/posts?search=development獲得結果。

POST 請求

POST 請求用於發送數據。 例如,借助新 API 的功能,您可以更新用戶。 假設您想更新 ID 為 10 的用戶。您所要做的就是向/wp-json/wp/v2/users/10發送一個 POST 請求。

要嘗試這一點,我建議使用 Google Chrome 擴展程序 Postman。

更多的 Javascript 混合在一起

Backbone.js 和 API

Backbone.js 是使用 API 的好方法,因為它是為使用 REST API 而設計的框架。 WordPress API 包含一個基於 Backbone 模型的易於使用的 Javascript API。 這允許插件和主題開發人員啟動和運行,而無需非常深入的努力和有關連接細節的知識。 它還有很多其他功能,但 Backbone 通過提供模型、集合和視圖來為 Web 應用程序提供結構,並通過 REST JSON 接口將它們全部連接到 WordPress API。

wordpress-api-backbone

這對 WordPress 開發人員意味著什麼?

隨著 WordPress API 的推出,使用它的新方法已經增加,並且隨著它的普及將繼續這樣做。 WordPress API 可以改進幾乎所有依賴 Javascript 的現有 WordPress 功能。 這裡有一些例子:

  • 表單驗證/提交
  • Backbone.js 主題或插件
  • 無限滾動

這也是展示其他來源內容的好方法。 現在,可以輕鬆地在多站點設置中顯示來自單個站點的內容。 也可以顯示來自完全獨立的 WordPress 網站的內容。 除了顯示內容,還可以更新內容。

現在我們已經了解了一些基本術語,我們知道 JSON 是表示法,REST 是架構風格,API 是它們組成的接口。 了解 API 的基礎知識及其功能將確保您在探索 WordPress API 的新可能性時有一個良好的開端。