页面

最后更新于：2021-11-29 22:38:55

Pages

结构

结构定义了页面数据中存在的所有字段。除非使用“_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
permalink_template

string 		对象的永久链接模板。
只读
Context: edit
generated_slug

string 		对象标题自动生成的Slug。
只读
Context: edit
parent

integer 		父对象的ID。
Context: view, edit
title

object 		对象的标题。
Context: view, edit, embed
content

object 		对象的内容。
Context: view, edit
author

integer 		对象作者的ID。
Context: view, edit, embed
excerpt

object 		该对象的摘录。
Context: view, edit, embed
featured_media

integer 		对象的特色图片的ID。
Context: view, edit, embed
comment_status

string 		对象的是否开启评论。
Context: view, edit
唯一: open, closed
ping_status

string 		对象是否允许评论pingback。
Context: view, edit
唯一: open, closed
menu_order

integer 		对象基于类型排序。
Context: view, edit
meta

object 		元字段。
Context: view, edit
template

string 		用于显示对象的主题文件。
Context: view, edit

页面集合

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

定义

GET /gc/v2/pages

请求示例

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

参数

context提交请求的数据结构；明确响应字段结构。
默认: view
唯一: view, embed, edit
page集合的分页页码
默认: 1
per_page返回结果集的最大条数。
默认: 10
search字符串匹配的结果集。
after限制对给定ISO8601合规日期后发布的文章的响应。
author将将结果集限制为指定给特定作者的文章。
author_exclude确保结果集不包括分配给特定作者的文章。
before限制对给定ISO8601兼容日期之前发布的文章的响应。
exclude确保结果集排除特定ID。
include将结果集限制为特定ID。
menu_order将结果集限制为具有特定菜单顺序值的文章。
offset将结果集偏移特定数量的项。
order排序属性升序或降序。
默认: desc
唯一: asc, desc
orderby按对象属性对集合排序。
默认: date
唯一: author, date, id, include, modified, parent, relevance, slug, include_slugs, title, menu_order
parent将结果集限制为具有特定父ID的项。
parent_exclude将结果集限制为除特定父ID之外的所有项。
slug将结果集限制为具有一个或多个特定段塞的文章。
status将结果集限制为分配了一个或多个状态的文章。
默认: publish

创建页面

参数

date对象发布的日期，基于站点时区。
date_gmt对象发布的日期，以GMT为单位。
slug对象的字母数字标识符，其类型是唯一的。
status对象的命名状态。
唯一: publish, future, draft, pending, private
password用于保护对内容和摘录的访问的密码。
parent父对象的ID。
title对象的标题。
content对象的内容。
author对象作者的ID。
excerpt该对象的摘录。
featured_media对象的特色图片的ID。
comment_status对象的是否开启评论。
唯一: open, closed
ping_status对象是否允许评论pingback。
唯一: open, closed
menu_order对象基于类型排序。
meta元字段。
template用于显示对象的主题文件。

定义

POST /gc/v2/pages

检索页面

定义 & 请求示例

GET /gc/v2/pages/<id>

Query this endpoint to retrieve a specific page record.

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

参数

id对象的唯一标识符。
context提交请求的数据结构；明确响应字段结构。
默认: view
唯一: view, embed, edit
password文章的密码（如果有密码保护）。

修改页面

参数

id对象的唯一标识符。
date对象发布的日期，基于站点时区。
date_gmt对象发布的日期，以GMT为单位。
slug对象的字母数字标识符，其类型是唯一的。
status对象的命名状态。
唯一: publish, future, draft, pending, private
password用于保护对内容和摘录的访问的密码。
parent父对象的ID。
title对象的标题。
content对象的内容。
author对象作者的ID。
excerpt该对象的摘录。
featured_media对象的特色图片的ID。
comment_status对象的是否开启评论。
唯一: open, closed
ping_status对象是否允许评论pingback。
唯一: open, closed
menu_order对象基于类型排序。
meta元字段。
template用于显示对象的主题文件。

定义

POST /gc/v2/pages/<id>

请求示例

删除页面

参数

id对象的唯一标识符。
force是否绕过垃圾箱并强制删除。

定义

DELETE /gc/v2/pages/<id>

请求示例

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