二. WordPress REST API 的背景與意義

WordPress REST API 于 2016 年 12 月隨 WordPress 4.7 核心版本發布，之前以插件形式存在。它將 WordPress 從傳統 CMS 轉變為應用程序平臺，使網站與應用程序開發更靈活。

1. 主要應用

• Gutenberg 編輯器：區塊編輯器通過 REST API 與數據庫交互。
• 單頁應用程序（SPA）：支持基于 JavaScript 的 SPA 開發。

2. 對用戶與開發者的影響

• 普通用戶：界面體驗改善，例如 Gutenberg 編輯器。
• 開發者：可創建外觀與 WordPress 不同的 SPA，并利用更多 JavaScript 技術。

三. 如何訪問 WordPress REST API

1. 使用 WP-CLI

WP-CLI 是 WordPress 的命令行工具，可通過命令行管理 WordPress 網站：

1. 在 Mac/Linux 打開終端，Windows 打開命令提示符。
2. 通過 SSH 連接服務器，或在本地測試環境中操作。

3. REST API 基礎路徑示例：

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

2. 身份驗證

• 需要身份驗證：訪問草稿狀態帖子。示例命令：

curl -X GET --user username:password -i http://yoursite.com/wp-json/wp/v2/posts?status=draft

• 無需身份驗證：訪問已發布帖子：

curl -X GET http://yoursite.com/wp-json/wp/v2/posts

四. 常用 REST API 命令

1. GET

獲取資源，例如獲取所有已發布帖子：

curl -X GET http://yoursite.com/wp-json/wp/v2/posts/?status=published

2. POST

創建新資源，例如新建帖子：

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

3. PUT

更新資源，例如將草稿狀態的帖子發布：

curl -X PUT http://yoursite.com/wp-json/wp/v2/posts/567 -d '{"status":"publish"}'

4. DELETE

刪除資源，例如刪除帖子：

curl -X DELETE http://yoursite.com/wp-json/wp/v2/posts/567

五. 使用 REST API 的注意事項

1. 兼容性

不支持 JavaScript 或禁用 JavaScript 的設備，REST API 無法工作。

2. 可訪問性

基于 JavaScript 的網站可能對屏幕閱讀器支持較差，需要優化。

3. SEO 影響

單頁應用程序可能導致部分內容無法被搜索引擎索引，需要特別關注 SEO。

六. 如何禁用 REST API

可通過以下方式限制訪問：

1. 安裝“禁用 WP REST API”插件。
2. 在主題 functions.php 文件中添加：

add_filter('json_enabled', '__return_false');
add_filter('json_jsonp_enabled', '__return_false');

七. REST API 的實際應用案例

• WordPress.com：管理界面完全基于 REST API 構建 SPA。
• Gutenberg 編輯器：通過 REST API 與數據庫交互，實現區塊編輯。
• Event Espresso：活動管理插件提供外部數據訪問能力。
• 今日美國：通過 REST API 將內容推送到 Facebook 即時文章和 Apple News，并開發 JavaScript 社交游戲。

八. 總結

WordPress REST API 為開發者提供了強大工具，使應用程序開發更靈活，但在使用時需考慮兼容性、可訪問性與 SEO 問題。合理使用 REST API，可以為 WordPress 項目帶來更多創新可能。

原文鏈接: https://kinsta.com/blog/wordpress-rest-api/