编辑块

最后更新于:2021-11-29 15:42:23

Editor Blocks

结构

该结构定义了编辑器块数据中存在的所有字段。除非使用“_filter”查询参数构造字段,否则来自这些端点的任何响应都可以包含以下字段。

date

string or null,
datetime (details)
对象在网站时区发布日期。
Context: vieweditembed
date_gmt

string or null,
datetime (details)
对象的发布日期,如格林尼治(GMT)标准时间。
Context: viewedit
guid

object 
对象的全局唯一标识符。
只读
Context: viewedit
id

integer 
对象的唯一标识符。
只读
Context: vieweditembed
link

string,
uri
对象的URL。
只读
Context: vieweditembed
modified

string,
datetime (details)
上次修改对象的日期,在网站的时区。
只读
Context: viewedit
modified_gmt

string,
datetime (details)
上次修改对象的日期,如GMT

只读
Context: viewedit
slug

string 
其类型独有的对象的字母数字标识符。
Context: vieweditembed
status

string 
对象的命名状态。
Context: viewedit
唯一: publishfuturedraftpendingprivate
type

string 
对象的文章类型。
只读
Context: vieweditembed
password

string 
保护对内容和摘录的访问的密码。
Context: edit
title

object 
对象的标题。
Context: vieweditembed
content

object 
对象的内容。
Context: viewedit
template

string 
用于显示对象的主题文件。
Context: viewedit

列表编辑器块

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

定义

GET /gc/v2/blocks

请求示例

$ curl https://example.com/gc-json/gc/v2/blocks

参数

context提出请求的范围;确定响应字段。
默认: view
唯一: viewembededit
page集合的分页页码
默认: 1
per_page返回结果集的最大条数。
默认: 10
search字符串匹配的结果集。
after限制对给定ISO8601合规日期后发布的文章的响应。
before限制对给定ISO8601兼容日期之前发布的文章的响应。
exclude确保结果集排除特定ID。
include将结果集限制为特定ID。
offset将结果集偏移特定数量的项。
order排序属性升序或降序。
默认: desc
唯一: ascdesc
orderby按对象属性对集合排序。
默认: date
唯一: authordateidincludemodifiedparentrelevancesluginclude_slugstitle
slug将结果集限制为具有一个或多个特定段塞的文章。
status将结果集限制为分配了一个或多个状态的文章。
默认: publish

创建编辑器块

参数

date对象发布的日期,基于站点时区。
date_gmt对象发布的日期,以GMT为单位。
slug对象的字母数字标识符,其类型是唯一的。
status对象的命名状态。
唯一: publishfuturedraftpendingprivate
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
唯一: viewembededit
password文章的密码(如果有密码保护)。

修改编辑器块

参数

id对象的唯一标识符。
date对象发布的日期,基于站点时区。
date_gmt对象发布的日期,以GMT为单位。
slug对象的字母数字标识符,其类型是唯一的。
status对象的命名状态。
唯一: publishfuturedraftpendingprivate
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>