WordPress API:它們是什麼以及如何使用它們
已發表: 2024-09-13WordPress JSON REST API 在 WordPress 社群中引起了不小的轟動,為開發人員和內容創作者等提供了新的可能性。
雖然聽起來可能很複雜,但了解 JSON、REST 和 API 等關鍵術語可以簡化您與 WordPress 廣泛功能的互動方式。
什麼是 API?
API 代表“應用程式介面”,本質上是一組允許不同軟體應用程式相互通訊的程式指令和標準。
想像一個軟體應用程式向另一個軟體應用程式發出指示——API 是管理這種互動的一組商定的規則。當一個軟體向另一個軟體發送指令時,API 會促進操作或提供必要的資訊。
您可以將 API 視為兩個軟體系統之間的“使用者介面”,處理資料通訊和任務執行,但對最終使用者不可見。
API 範例
當您開發 Web 應用程式時,能夠存取 API 真是太棒了。當 API 向公眾發佈時,表示開發人員創建了由該軟體服務提供支援的解決方案。通常,它們消除了許多任務重新發明輪子的需要,因為它們已經被創建了。
亞馬遜就是 API 的一個很好的例子。亞馬遜發布了其API,以便開發人員可以輕鬆存取產品及其資訊。訪問此功能可以輕鬆地在亞馬遜上發布產品鏈接,並提供更新的價格和購買選項。
API 互動的另一個例子是音樂會門票購買。要正式購買門票,您需要輸入您的信用卡資訊。 API 用於將您的信用卡資訊傳送到遠端應用程序,然後該應用程式會驗證信用卡資訊是否正確。
一切檢查完畢後,遠端應用程式會將回應發送回門票網站,表示可以繼續,此時您已成功購買門票。當這一切發生時,你只看到一個介面,那就是票務網站。這是一個無縫的過程;在幕後,許多應用程式使用 API 一起工作,但作為用戶,您不會注意到任務何時從一個應用程式移交給另一個應用程式。
API 和 WordPress
亞馬遜和票務購買是 API 如何協同工作的絕佳範例,但這如何應用於 WordPress?
嗯,所有相同的想法都適用。使用 WordPress API,您可以將資料推送到 WordPress 或從 WordPress 中提取資料。
API 是一個關鍵工具,開發人員可以使用它輕鬆地將 WordPress 網站的資料分享到其他網站或應用程式。具體來說,此 API 允許您對 WordPress 內容執行create
、 read
、 update
和delete
(CRUD) 操作。內容類型的一些範例是:
- 貼文
- 自訂貼文類型
- 頁數
- 分類法
- 使用者
- 媒體
休息是什麼意思?
這裡沒有打瞌睡或打鼾——REST 指的是 API 的架構風格。 REST 代表表述性狀態轉移。
還記得我們如何提到 API 提供了通訊細節,以便程式可以相互通訊嗎? REST API 的設計方式是提供一種輕量級的通訊方法,從而節省頻寬。 WordPress JSON REST API 就是這樣做的,當資料量很大時,它是一個很好的選擇。
我們剛觸及 REST 的皮毛;如果您想了解更多信息,請查看此 REST 有用教程。
JSON格式
為了存取數據,我們需要一個來源。這就是 JSON 的用武之地。
JSON 對於人類和機器來說都很容易閱讀和理解。這是以有組織且易於存取的方式儲存資訊的完美方式。由於 JSON 非常容易訪問,因此非常適合創建 REST API,並且是 WordPress JSON REST API 的完美解決方案。
以下是 JSON 格式的基本概念:
[javascript]
{「僱員」:[
{“名字”:“簡”,“姓氏”:“史密斯”},
{“firstName”:“安娜”,“lastName”:“奧爾森”},
{“名字”:“喬什”,“姓氏”:“瓊斯”}
]}
[/javascript]
WordPress 中的 JSON 格式
JSON 不只是自己編寫,但不用擔心,您不必手動建立 JSON 檔案。有一些插件可以為您創建它。使用這些工具之一,網站的資料將採用正確的格式,包括使用者、貼文、頁面、分類法等。
使用 JSON REST API
使用 API 是非常不言自明的;您將以簡單的 JSON 格式取得網站的資料。如果您安裝了插件,則可以嘗試以資料形式查看網站的貼文。
檢索或更新資料就像發送 HTTP 請求一樣簡單。 HTTP 是一種請求/回應協定。首先,您發送資料請求,然後資料作為回應發回。
獲取方法
GET方法用於檢索訊息,對資料沒有影響。只需將 GET 請求發送到/wp-json/wp/v2/posts
即可。想要尋找一些東西嗎?例如,如果您搜尋“development”,您將透過 GET 請求/wp-json/wp/v2/posts?search=development
獲得結果。
發布請求
POST 請求用於傳送資料。例如,利用新 API 的功能,您可以更新使用者。假設您要更新 ID 為 10 的/wp-json/wp/v2/users/10
。
要嘗試此操作,我們建議使用 Postman,一個 Google Chrome 擴充功能。
混合更多 Javascript
Backbone.js 和 API
Backbone.js 是使用 API 的好方法,因為它是一個專為使用 REST API 而設計的框架。 WordPress API 包含一個基於 Backbone 模型的易於使用的 Javascript API。這使得插件和主題開發人員無需超級深入的努力和了解連接的細節即可啟動並運行。
還有更多內容,但 Backbone 透過提供模型、集合和視圖為 Web 應用程式提供結構,並透過 REST JSON 介面將其全部連接到 WordPress API。
這對 WordPress 開發者意味著什麼?
隨著 WordPress API 的推出,使用它的新方法已經增加,隨著它的流行,這種情況還將繼續增加。 WordPress API 可以改進幾乎所有依賴 Javascript 的現有 WordPress 功能。以下是一些範例:
- 表單驗證/提交
- Backbone.js 主題或插件
- 無限滾動
這也是顯示其他來源的內容的好方法。現在,可以輕鬆地在多站點設定中顯示來自單一站點的內容。還可以顯示來自完全獨立的 WordPress 網站的內容。除了展示內容之外,內容的更新也可以更輕鬆有效。
現在我們已經了解了一些基本術語,我們知道 JSON 是表示法,REST 是架構風格,API 是它們組成的介面。了解 API 的基礎知識及其功能將確保您在探索 WordPress API 的新可能性時有一個良好的開端。