WP REST API在整個API中集成了超鏈接,以允許可發現性和可瀏覽性,并在一個響應中嵌入相關資源。雖然REST API不完全符合整個HAL標準,但是它將按照下面的描述從該標準中實現._links和._embedded屬性。
##鏈接
響應對象的_links屬性包含指向其他API資源的鏈接映射,按“關系”分組。該關系指定鏈接資源與主資源的關聯。 (例子包括描述資源及其作者之間的關系的“作者”,或描述一個帖子與其標簽或類別之間的關系的“wp:term”)。關系是標準化關系,URI關系https://api.w.org/term)或緊湊的URI關系(如wp:term)。 (緊湊型URI關系可以歸一化為完全的URI關系,以確保完全兼容性,如果需要)。這與HTML`<link>`標簽或`<a rel="">`鏈接類似。
鏈接是包含href屬性的對象,其中包含資源的絕對URL,以及其他可選屬性。這些包括內容類型,消歧信息以及可以通過鏈接采取的操作的數據。
對于收集響應(返回對象列表而不是頂級對象的響應),每個項目都包含鏈接,頂層響應包含通過鏈接頭的鏈接。
>[warning] 注意:如果您的客戶端庫不允許訪問標題,可以使用_envelope參數將標題作為正文數據。
## 響應示例
典型的單一帖子請求(/ wp / v2 / posts / 42):
```
{
"id": 42,
"_links": {
"collection": [
{
"href": "https://demo.wp-api.org/wp-json/wp/v2/posts"
}
],
"author": [
{
"href": "https://demo.wp-api.org/wp-json/wp/v2/users/1",
"embeddable": true
}
]
}
}
```
## 嵌入
可選地,一些鏈接的資源可以包括在響應中以減少所需的HTTP請求的數量。 這些資源被“嵌入”為主要響應。
通過在請求上設置_embed查詢參數來觸發嵌入。 然后,這將包括與_links鍵相鄰的_embedded鍵下的嵌入資源。 此對象的布局反映_links對象,但包含嵌入式資源代替鏈接屬性。
只有嵌入標志設置為true的鏈接才能被嵌入,并且_embed將導致嵌入所有嵌入式鏈接。 只有包含嵌入式響應的關系才包含在_embedded中,然而與混合嵌入式和不可嵌入鏈接的關系將包含用于不可嵌入鏈接的虛擬響應,以確保數字索引與_links中的匹配。
## 響應示例
```
{
"id": 42,
"_links": {
"collection": [
{
"href": "https://demo.wp-api.org/wp-json/wp/v2/posts"
}
],
"author": [
{
"href": "https://demo.wp-api.org/wp-json/wp/v2/users/1",
"embeddable": true
}
]
},
"_embedded": {
"author": {
"id": 1,
"name": "admin",
"description": "Site administrator"
}
}
}
```
- 簡介
- 主題開發
- 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
- 添加自定義端點
- 自定義內容類型
- 修改回應
- 模式
- 詞匯表
- 路由和端點
- 控制器類