# REST API 手冊
WordPress REST API為WordPress數據類型提供API端點,允許開發人員通過發送和接收JSON(JavaScript對象符號)對象遠程與站點進行交互。 JSON是一種開放標準的數據格式,它是輕量級和可讀的,看起來像是在JavaScript中的對象; 由此得名。 當您向API發送內容或發出請求時,將以JSON返回響應。 這使開發人員能夠從客戶端JavaScript或外部應用程序創建,閱讀和更新WordPress內容,甚至是用PHP語言編寫的內容。
尋找WordPress中可用的其他API的列表? 您可以在這里找到文檔。
# 如何使用WordPress REST API
WordPress REST API使以前更容易使用WordPress新的和令人興奮的方式,如在WordPress之上創建單頁應用程序。您可以創建一個插件,為WordPress提供全新的管理體驗,或創建全新的互動前端體驗。
您甚至不必在PHP中編寫應用程序:可以使HTTP請求和解釋JSON的任何編程語言都可以通過REST API從Node.js到Java以及其他方面與WordPress進行交互。
WordPress REST API也可以作為核心中的admin-ajax API的強大替代品。通過使用REST API,您可以更輕松地構建要將數據導入和移出WordPress的方式。通過使用REST API可以大大簡化AJAX調用,使您能夠花更少的時間訪問所需的數據,更多的時間創建更好的用戶體驗。
我們的想象力是WordPress REST API可以做到的唯一限制。底線是,如果您希望使用結構化,可擴展和簡單的方式通過HTTP獲取和傳出WordPress中的數據,則可能需要使用REST API。對于所有的簡單性,REST API首先可以感覺到相當復雜,我們將嘗試將其分解成較小的組件,以便我們可以輕松地整理拼圖。
## 關鍵概念
要開始使用WordPress REST API,我們將分解與API相關聯的一些關鍵概念和術語:
- Routes/Endpoints
- Requests
- Responses
- Schema
- Controller Classes
這些概念中的每一個在使用和理解WordPress REST API方面起關鍵作用。 讓我們簡單地將它們分解下來,以便我們能夠更深入地探索每一個。
## Routes & Endpoints
在WordPress REST API的上下文中,路由是可以映射到不同HTTP方法的URI。單個HTTP方法映射到路由被稱為“端點”。要澄清:如果我們向http://oursite.com/wp-json/發出GET請求,我們將獲得一個JSON響應,顯示我們可用的路由,并在每個路由中提供哪些端點。 / wp-json /是一個路由本身,當GET請求被創建時,它與顯示所謂的WordPress REST API的索引的端點相匹配。我們將在以下部分中學習如何注冊自己的路由和端點。
## Requests
WordPress REST API基礎架構中的主要類之一是WP_REST_Request。此類用于存儲和檢索當前請求的信息;請求可以通過HTTP遠程提交,但也可以通過WordPress從PHP內部進行。當您向注冊的路由發出HTTP請求時,WP_REST_Request對象將自動生成。請求中指定的數據將確定您從API中返回的響應。使用請求類可以做很多整齊的事情。請求部分將進一步詳細介紹。
## Responses
響應是從API獲取的數據。 WP_REST_Response提供了一種與端點返回的響應數據交互的方法。響應可以返回所需的數據,也可以用于返回錯誤。
## 模式
每個端點都要求并提供稍微不同的數據結構,這些結構在API模式中定義。 模式結構API數據,并提供了API可以返回的所有屬性以及可以接受的輸入參數的綜合列表。 模式還為API提供安全性好處,因為它使我們能夠驗證對API所做的請求。 模式部分進一步探討了這個大題目。
##控制器類
您可以看到,WordPress REST API有很多移動部分,所有這些都需要一起工作。 控制器類將所有這些元素放在一起。 使用控制器類,您可以管理路由和端點的注冊,處理請求,使用模式和生成API響應。
- 簡介
- 主題開發
- WordPress許可證
- 什么是主題
- 開發環境
- 主題開發示例
- 主題基礎
- 模板文件
- 主樣式表(style.css)
- 文章類型
- 規劃主題文件
- 模板層級
- 模板標簽
- 循環
- 主題函數
- 連接主題文件和目錄
- 使用CSS和JavaScript
- 條件標簽
- 類別,標簽和自定義分類
- 模板文件
- 內容模板文件
- 頁面模板文件
- 附件模板文件
- 自定義內容類型
- 部分和其他模板文件
- 評論模板
- 分類模板
- 404頁面
- 主題功能
- 核心支持的功能
- 管理菜單
- 自定義Headers
- 自定義Logo
- 文章格式
- 置頂文章
- Sidebars
- Widgets
- 導航菜單
- 分頁
- 媒體
- Audio
- Images
- Galleries
- Video
- 精選圖片和縮略圖
- 國際化
- 本地化
- 輔助功能
- 主題選項 – 自定義API
- 定制對象
- 改進用戶體驗的工具
- 定制JavaScript API
- JavaScript / Underscore.js渲染的自定義控件
- 高級用法
- 主題安全
- 數據消毒/逃避
- 數據驗證
- 使用隨機數
- 常見漏洞
- 高級主題
- 子主題
- UI最佳實踐
- JavaScript最佳做法
- 主題單元測試
- 驗證你的主題
- Plugin API Hooks
- 發布你的主題
- 所需的主題文件
- 測試
- 主題評論指南
- 寫文檔
- 提交你的主題到WordPress.org
- 參考文獻
- 模板標簽列表
- 條件標簽列表
- 編碼標準
- HTML編碼標準
- CSS編碼標準
- JavaScript編碼標準
- PHP編碼標準
- 插件開發
- 插件開發簡介
- 什么是插件
- 插件基礎
- 頭部要求
- 包括軟件許可證
- 啟用 / 停用 Hooks
- 卸載方法
- 最佳做法
- 插件安全
- 檢查用戶功能
- 數據驗證
- 保護輸入
- 保護輸出
- 隨機數
- Hooks
- Actions
- Filters
- 自定義Hooks
- 高級主題
- 管理菜單
- 頂級菜單
- 子菜單
- 短代碼
- 基本短碼
- 封閉短碼
- 帶參數的短代碼
- TinyMCE增強型短碼
- 設置
- 設置API
- 使用設置API
- 選項API
- 自定義設置頁面
- 元數據
- 管理帖子元數據
- 自定義元數據
- 渲染元數據
- 自定義文章類型
- 注冊自定義文章類型
- 使用自定義文章類型
- 分類
- 使用自定義分類
- 在WP 4.2+中使用“split術語”
- 用戶
- 創建和管理用戶
- 使用用戶元數據
- 角色和功能
- HTTP API
- JavaScript
- jQuery
- Ajax
- 服務器端PHP和入隊
- Heartbeat API
- 概要
- 計劃任務
- 了解WP-Cron計劃
- 安排WP-Cron 事件
- 將WP-Cron掛接到系統任務計劃程序中
- WP-Cron簡單測試
- 國際化
- 本地化
- 如何國際化您的插件
- 國際化安全
- WordPress.org
- 詳細插件指南
- 規劃您的插件
- 如何使用Subversion
- 插件開發者常見問題
- 開發工具
- Debug Bar 和附加組件
- 輔助插件
- REST API手冊
- 資源
- 文章
- 文章修訂
- 文章類型
- 文章狀態
- 類別
- 標簽
- 頁面
- 評論
- 分類
- 媒體
- 用戶
- 設置
- 使用REST API
- 全局參數
- 分頁
- 鏈接和嵌入
- 發現
- 認證
- 經常問的問題
- 骨干JavaScript客戶端
- 客戶端庫
- 擴展REST API
- 添加自定義端點
- 自定義內容類型
- 修改回應
- 模式
- 詞匯表
- 路由和端點
- 控制器類