架构

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

author 修订作者的 ID。

JSON 数据类型:整数

上下文:view、edit、embed

date 修订发布的日期(使用网站时区)。

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

上下文:view、edit、embed

date_gmt 修订发布的日期(GMT 时间)。

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

上下文:view、edit

guid 帖子的全局唯一标识符。

JSON 数据类型:对象

只读

上下文:view、edit

id 修订的唯一标识符。

JSON 数据类型:整数

上下文:view、edit、embed

modified 修订最后修改的日期(使用网站时区)。

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

上下文:view、edit

modified_gmt 修订最后修改的日期(GMT 时间)。

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

上下文:view、edit

parent 修订父级的 ID。

JSON 数据类型:整数

上下文:view、edit、embed

slug 针对其类型唯一的字母数字标识符。

JSON 数据类型:字符串

上下文:view、edit、embed

title 帖子的标题。

JSON 数据类型:对象

上下文:view、edit、embed

content 帖子的内容。

JSON 数据类型:对象

上下文:view、edit

excerpt 帖子的摘要。

JSON 数据类型:对象

上下文:view、edit、embed

列出页面修订

查询此端点以检索页面修订集合。您可以使用下面的 URL 查询参数来控制和过滤收到的响应。

定义

GET /wp/v2/pages/<parent>/revisions

示例请求

$ curl https://example.com/wp-json/wp/v2/pages/<parent>/revisions

参数

parent 修订父级的 ID。
context 请求的作用域;决定响应中存在的字段。

默认值:view

可选值:view、embed、edit

page 当前页码。

默认值:1

per_page 结果集中返回的最大项目数。
search 将结果限制为匹配指定字符串的记录。
exclude 确保结果集排除特定的 ID。
include 将结果集限制为特定的 ID。
offset 从结果集中偏移特定数量的项目。
order 排序属性按升序或降序排列。

默认值:desc

可选值:asc、desc

orderby 按对象属性对集合进行排序。

默认值:date

可选值:date、id、include、relevance、slug、include_slugs、title

获取页面修订

定义与示例请求

GET /wp/v2/pages/<parent>/revisions/<id>

查询此端点以检索特定的页面修订记录。

$ curl https://example.com/wp-json/wp/v2/pages/<parent>/revisions/<id>

参数

parent 修订父级的 ID。
id 修订的唯一标识符。
context 请求的作用域;决定响应中存在的字段。

默认值:view

可选值:view、embed、edit

删除页面修订

参数

parent 修订父级的 ID。
id 修订的唯一标识符。
force 必须为 true,因为修订不支持回收站功能。

定义

DELETE /wp/v2/pages/<parent>/revisions/<id>

示例请求

$ curl -X DELETE https://example.com/wp-json/wp/v2/pages/<parent>/revisions/<id>

获取页面修订

定义与示例请求

GET /wp/v2/pages/<id>/autosaves

查询此端点以检索特定的页面修订记录。

$ curl https://example.com/wp-json/wp/v2/pages/<id>/autosaves

参数

parent 自动保存版本父级的 ID。
context 请求的作用域;决定响应中存在的字段。

默认值:view

可选值:view、embed、edit

创建页面修订

参数

parent 帖子父级的 ID。
date 帖子发布的日期(使用网站时区)。
date_gmt 帖子发布的日期(GMT 时间)。
slug 针对其类型唯一的字母数字标识符。
status 帖子的命名状态。
可选值:publish、future、draft、pending、private
password 用于保护访问内容和摘要的密码。
title 帖子的标题。
content 帖子的内容。
author 帖子作者的 ID。
excerpt 帖子的摘要。
featured_media 帖子特色媒体的 ID。
comment_status 帖子是否允许评论。
可选值:open、closed
ping_status 帖子是否可以被 Ping。
可选值:open、closed
menu_order 帖子相对于其他帖子的顺序。
meta 元数据字段。
template 用于显示帖子的主题文件。

定义

POST /wp/v2/pages/<id>/autosaves

获取页面修订

定义与示例请求

GET /wp/v2/pages/<parent>/autosaves/<id>

查询此端点以检索特定的页面修订记录。

$ curl https://example.com/wp-json/wp/v2/pages/<parent>/autosaves/<id>

参数

parent 自动保存版本父级的 ID。
id 自动保存版本的 ID。
context 请求的作用域;决定响应中存在的字段。

默认值:view

可选值:view、embed、edit