架构

架构定义了帖子修订记录中存在的所有字段。除非使用了 `_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/posts/<parent>/revisions

示例请求

$ curl https://example.com/wp-json/wp/v2/posts/<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/posts/<parent>/revisions/<id>

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

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

参数

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

默认值：view

可选值：view、embed、edit

删除帖子修订

参数

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

定义

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

示例请求

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

检索帖子修订

定义 & 示例请求

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

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

$ curl https://example.com/wp-json/wp/v2/posts/<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
format 帖子的格式。
可选值：standard、aside、chat、gallery、link、image、quote、status、video、audio
meta 元数据字段。
sticky 帖子是否应被视为置顶。
template 用于显示帖子的主题文件。
categories 分配给该帖子的分类法中的术语。
tags 分配给该帖子的 post_tag 分类法中的术语。

定义

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

检索帖子修订

定义 & 示例请求

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

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

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

参数

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

默认值：view

可选值：view、embed、edit