架构

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

列出块修订内容

查询此端点以检索块修订内容集合。您可以使用下方的 URL 查询参数来控制和过滤返回的响应。

定义

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

示例请求

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

查询此端点以检索特定的块修订内容记录。

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

参数

parent 父级对象的 ID。
id 修订内容的唯一标识符。
context 请求的作用域;决定响应中包含的字段。

默认值:view

可选值:view, embed, edit

删除块修订内容

参数

parent 父级对象的 ID。
id 修订内容的唯一标识符。
force 必须设为 true,因为修订内容不支持回收站。

定义

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

示例请求

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

检索块修订内容

定义 & 示例请求

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

查询此端点以检索特定的块修订内容记录。

$ curl https://example.com/wp-json/wp/v2/blocks/<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 帖子内容。
meta 元数据字段。
template 用于显示帖子的主题文件。

定义

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

检索块修订内容

定义 & 示例请求

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

查询此端点以检索特定的块修订内容记录。

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

参数

parent 自动保存内容的父级 ID。
id 自动保存内容的 ID。
context 请求的作用域;决定响应中包含的字段。

默认值:view

可选值:view, embed, edit