编辑块
最后更新于:2021-11-29 15:42:23
Editor Blocks
结构
该结构定义了编辑器块数据中存在的所有字段。除非使用“_filter”查询参数构造字段,否则来自这些端点的任何响应都可以包含以下字段。
date string or null, datetime (details) | 对象在网站时区发布日期。 Context: view , edit , embed |
date_gmt string or null, datetime (details) | 对象的发布日期,如格林尼治(GMT)标准时间。 Context: view , edit |
guid object | 对象的全局唯一标识符。 只读 Context: view , edit |
id integer | 对象的唯一标识符。 只读 Context: view , edit , embed |
link string, uri | 对象的URL。 只读 Context: view , edit , embed |
modified string, datetime (details) | 上次修改对象的日期,在网站的时区。 只读 Context: view , edit |
modified_gmt string, datetime (details) | 上次修改对象的日期,如GMT 只读 Context: view , edit |
slug string | 其类型独有的对象的字母数字标识符。 Context: view , edit , embed |
status string | 对象的命名状态。 Context: view , edit 唯一: publish , future , draft , pending , private |
type string | 对象的文章类型。 只读 Context: view , edit , embed |
password string | 保护对内容和摘录的访问的密码。 Context: edit |
title object | 对象的标题。 Context: view , edit , embed |
content object | 对象的内容。 Context: view , edit |
template string | 用于显示对象的主题文件。 Context: view , edit |
列表编辑器块
查询此端点以检索编辑器块的集合。您可以使用下面的URL查询参数来控制和过滤您收到的响应。
定义
GET /gc/v2/blocks
请求示例
$ curl https://example.com/gc-json/gc/v2/blocks
参数
context | 提出请求的范围;确定响应字段。 默认: view 唯一: view , embed , edit |
page | 集合的分页页码 默认: 1 |
per_page | 返回结果集的最大条数。 默认: 10 |
search | 字符串匹配的结果集。 |
after | 限制对给定ISO8601合规日期后发布的文章的响应。 |
before | 限制对给定ISO8601兼容日期之前发布的文章的响应。 |
exclude | 确保结果集排除特定ID。 |
include | 将结果集限制为特定ID。 |
offset | 将结果集偏移特定数量的项。 |
order | 排序属性升序或降序。 默认: desc 唯一: asc , desc |
orderby | 按对象属性对集合排序。 默认: date 唯一: author , date , id , include , modified , parent , relevance , slug , include_slugs , title |
slug | 将结果集限制为具有一个或多个特定段塞的文章。 |
status | 将结果集限制为分配了一个或多个状态的文章。 默认: publish |
创建编辑器块
参数
date | 对象发布的日期,基于站点时区。 |
date_gmt | 对象发布的日期,以GMT为单位。 |
slug | 对象的字母数字标识符,其类型是唯一的。 |
status | 对象的命名状态。 唯一: publish , future , draft , pending , private |
password | 用于保护对内容和摘录的访问的密码。 |
title | 对象的标题。 |
content | 对象的内容。 |
template | 用于显示对象的主题文件。 |
定义
POST /gc/v2/blocks
检索编辑器块
定义 & 请求示例
GET /gc/v2/blocks/<id>
查询此端点以检索特定的编辑器块数据。
$ curl https://example.com/gc-json/gc/v2/blocks/<id>
参数
id | 对象的唯一标识符。 |
context | 提交请求的数据结构;明确响应字段结构。 默认: view 唯一: view , embed , edit |
password | 文章的密码(如果有密码保护)。 |
修改编辑器块
参数
id | 对象的唯一标识符。 |
date | 对象发布的日期,基于站点时区。 |
date_gmt | 对象发布的日期,以GMT为单位。 |
slug | 对象的字母数字标识符,其类型是唯一的。 |
status | 对象的命名状态。 唯一: publish , future , draft , pending , private |
password | 用于保护对内容和摘录的访问的密码。 |
title | 对象的标题。 |
content | 对象的内容。 |
template | 用于显示对象的主题文件。 |
定义
POST /gc/v2/blocks/<id>
请求示例
删除编辑器块
参数
id | 对象的唯一标识符。 |
force | 是否绕过垃圾箱并强制删除。 |
定义
DELETE /gc/v2/blocks/<id>
请求示例
$ curl -X DELETE https://example.com/gc-json/gc/v2/blocks/<id>