文章

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

Posts

结构

结构定义了文章数据中存在的所有字段。除非使用“_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`
`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`
`format` string	The format for the object. Context: `view`, `edit` 唯一: `standard`, `aside`, `chat`, `gallery`, `link`, `image`, `quote`, `status`, `video`, `audio`
`meta` object	元字段。 Context: `view`, `edit`
`sticky` boolean	Whether or not the object should be treated as sticky. Context: `view`, `edit`
`template` string	用于显示对象的主题文件。 Context: `view`, `edit`
`categories` array	在分类类型中指定给对象的分类项。 Context: `view`, `edit`
`tags` array	在分类类型中指定给对象的文章标签。 Context: `view`, `edit`

文章列表

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

定义

GET /gc/v2/posts

请求示例

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

参数

`context`	提交请求的数据结构；明确响应字段结构。默认: `view` 唯一: `view`, `embed`, `edit`
`page`	集合的分页页码默认: `1`
`per_page`	返回结果集的最大条数。默认: `10`
`search`	字符串匹配的结果集。
`after`	限制对给定ISO8601合规日期后发布的文章的响应。
`author`	将将结果集限制为指定给特定作者的文章。
`author_exclude`	确保结果集不包括分配给特定作者的文章。
`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`
`tax_relation`	Limit result set based on relationship between multiple taxonomies. 唯一: `AND`, `OR`
`categories`	Limit result set to all items that have the specified term assigned in the categories taxonomy.
`categories_exclude`	Limit result set to all items except those that have the specified term assigned in the categories taxonomy.
`tags`	Limit result set to all items that have the specified term assigned in the tags taxonomy.
`tags_exclude`	Limit result set to all items except those that have the specified term assigned in the tags taxonomy.
`sticky`	Limit result set to items that are sticky.

创建文章

参数

`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`	对象是否允许评论pingback。唯一: `open`, `closed`
`format`	The format for the object. 唯一: `standard`, `aside`, `chat`, `gallery`, `link`, `image`, `quote`, `status`, `video`, `audio`
`meta`	元字段。
`sticky`	Whether or not the object should be treated as sticky.
`template`	用于显示对象的主题文件。
`categories`	在分类类型中指定给对象的分类项。
`tags`	在分类类型中指定给对象的文章标签。

定义

POST /gc/v2/posts

检索一篇文章

定义 & 请求示例

GET /gc/v2/posts/<id>

查询此端点以检索特定的文章数据。

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

参数

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

修改文章

参数

`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`	对象是否允许评论pingback。唯一: `open`, `closed`
`format`	The format for the object. 唯一: `standard`, `aside`, `chat`, `gallery`, `link`, `image`, `quote`, `status`, `video`, `audio`
`meta`	元字段。
`sticky`	Whether or not the object should be treated as sticky.
`template`	用于显示对象的主题文件。
`categories`	在分类类型中指定给对象的分类项。
`tags`	在分类类型中指定给对象的文章标签。

定义

POST /gc/v2/posts/<id>

请求示例

$ curl -X POST https://example.com/gc-json/gc/v2/posts/<id> -d '{"title":"My New Title"}'

删除一篇文章

参数

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

定义

DELETE /gc/v2/posts/<id>

请求示例

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