架构

架构定义了模板记录中存在的所有字段。除非使用了 `_filter` 查询参数,或者该架构字段仅出现在特定上下文中,否则这些端点的任何响应都应包含以下字段。

id 模板的 ID。

JSON 数据类型:字符串

只读

上下文:embed, view, edit

slug 标识模板的唯一 slug。

JSON 数据类型:字符串

上下文:embed, view, edit

theme 模板的主题标识符。

JSON 数据类型:字符串

上下文:embed, view, edit

type 模板类型。

JSON 数据类型:字符串

上下文:embed, view, edit

source 模板的来源

JSON 数据类型:字符串

只读

上下文:embed, view, edit

origin 自定义模板的来源

JSON 数据类型:字符串

只读

上下文:embed, view, edit

content 模板内容。

JSON 数据类型:对象或字符串

上下文:embed, view, edit

title 模板标题。

JSON 数据类型:对象或字符串

上下文:embed, view, edit

description 模板描述。

JSON 数据类型:字符串

上下文:embed, view, edit

status 模板状态。

JSON 数据类型:字符串

上下文:embed, view, edit

其中之一:publish, future, draft, pending, private

wp_id 文章 ID。

JSON 数据类型:整数

只读

上下文:embed, view, edit

has_theme_file 主题文件是否存在。

JSON 数据类型:布尔值

只读

上下文:embed, view, edit

author 模板作者的 ID。

JSON 数据类型:整数

上下文:view, edit, embed

modified 模板上次修改的日期(按站点时区)。

JSON 数据类型:字符串
格式:datetime (详情)

只读

上下文:view, edit

is_custom 模板是否为自定义模板。

JSON 数据类型:布尔值

只读

上下文:embed, view, edit

检索模板

定义与示例请求

GET /wp/v2/templates

查询此端点以检索特定的模板记录。

$ curl https://example.com/wp-json/wp/v2/templates

参数

context 请求的范围;确定响应中存在的字段。

默认值:view

其中之一:view, embed, edit

wp_id 限制为指定的文章 ID。
area 限制为指定的模板部分区域。
post_type 获取其模板的文章类型。

创建模板

参数

slug 标识模板的唯一 slug。

必需:是

theme 模板的主题标识符。
type 模板类型。
content 模板内容。
title 模板标题。
description 模板描述。
status 模板状态。

默认值:publish

其中之一:publish, future, draft, pending, private

author 模板作者的 ID。

定义

POST /wp/v2/templates

检索模板

定义与示例请求

GET /wp/v2/templates/<id>?)[\/\w%-]+)

查询此端点以检索特定的模板记录。

$ curl https://example.com/wp-json/wp/v2/templates/<id>?)[\/\w%-]+)

参数

id 模板的 ID
context 请求的范围;确定响应中存在的字段。

默认值:view

其中之一:view, embed, edit

更新模板

参数

id 模板的 ID
slug 标识模板的唯一 slug。
theme 模板的主题标识符。
type 模板类型。
content 模板内容。
title 模板标题。
description 模板描述。
status 模板状态。
其中之一:publish, future, draft, pending, private
author 模板作者的 ID。

定义

POST /wp/v2/templates/<id>?)[\/\w%-]+)

示例请求

无

删除模板

参数

id 模板的 ID
force 是否绕过废纸篓并强制删除。

定义

DELETE /wp/v2/templates/<id>?)[\/\w%-]+)

示例请求

$ curl -X DELETE https://example.com/wp-json/wp/v2/templates/<id>?)[\/\w%-]+)