文章修订
最后更新于:2021-11-29 22:30:31
Post Revisions
结构
Th该结构定义了文章修订后数据中存在的所有字段。除非使用“_filter”查询参数构造字段,否则来自这些端点的任何响应都可以包含以下字段。
author integer | 对象作者的ID。 Context: view , edit , embed |
date string, datetime (details) | 对象发布的日期,基于站点时区。 Context: view , edit , embed |
date_gmt string, datetime (details) | 对象发布的日期,以GMT为单位。 Context: view , edit |
guid object | 对象的全局唯一标识符。 只读 Context: view , edit |
id integer | 对象的唯一标识符。 Context: view , edit , embed |
modified string, datetime (details) | 上次修改对象的日期,基于站点时区。 Context: view , edit |
modified_gmt string, datetime (details) | 上次修改对象的日期,以GMT为单位。 Context: view , edit |
parent integer | 父对象的ID。 Context: view , edit , embed |
slug string | 对象的字母数字标识符,其类型是唯一的。 Context: view , edit , embed |
title object | 对象的标题。 Context: view , edit , embed |
content object | 对象的内容。 Context: view , edit |
excerpt object | 该对象的摘录。 Context: view , edit , embed |
文章修订集合
查询此端点以检索文章修订的集合。您可以使用下面的URL查询参数来控制和过滤您收到的响应。
定义
GET /gc/v2/posts/<parent>/revisions
请求示例
$ curl https://example.com/gc-json/gc/v2/posts/<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 /gc/v2/posts/<parent>/revisions/<id>
Query this endpoint to retrieve a specific post revision record.
$ curl https://example.com/gc-json/gc/v2/posts/<parent>/revisions/<id>
参数
parent | 父对象的ID。 |
id | 对象的唯一标识符。 |
context | 提交请求的数据结构;明确响应字段结构。 默认: view 唯一: view , embed , edit |
删除文章修订
参数
parent | 父对象的ID。 |
id | 对象的唯一标识符。 |
force | Required to be true, as revisions do not support trashing. |
定义
DELETE /gc/v2/posts/<parent>/revisions/<id>
请求示例
$ curl -X DELETE https://example.com/gc-json/gc/v2/posts/<parent>/revisions/<id>
检索单个文章修订
定义 & 请求示例
GET /gc/v2/posts/<id>/autosaves
查询此端点以检索特定的修订数据。
$ curl https://example.com/gc-json/gc/v2/posts/<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 | 对象的内容。 |
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>/autosaves
检索文章修订
定义 & 请求示例
GET /gc/v2/posts/<parent>/autosaves/<id>
查询此端点以检索特定的修订后数据。
$ curl https://example.com/gc-json/gc/v2/posts/<parent>/autosaves/<id>
参数
parent | 父对象的ID。 |
id | 对象的ID。 |
context | 提交请求的数据结构;明确响应字段结构。 默认: view 唯一: view , embed , edit |