帖子
图式
该模式定义了帖子记录中存在的所有字段。除非使用“_filter”查询参数或模式字段仅出现在特定上下文中，否则来自这些端点的任何响应都应包含以下字段。
| date 字符串或 null， 日期时间（详细信息） | 对象发布的日期，以站点的时区表示。 上下文：view, edit,embed |
| date_gmt 字符串或 null， 日期时间（详细信息） | 对象发布的日期，作为 GMT。 上下文: view,edit |
| guid 目的 | 对象的全局唯一标识符。 只读 上下文: view,edit |
| id 整数 | 对象的唯一标识符。 只读 上下文：view, edit,embed |
| link 字符串， uri | 对象的 URL。 只读 上下文：view, edit,embed |
| modified 字符串， 日期时间（详细信息） | 上次修改对象的日期，以站点的时区表示。 只读 上下文: view,edit |
| modified_gmt 字符串， 日期时间（详细信息） | 上次修改对象的日期，如 GMT。 只读 上下文: view,edit |
| slug 细绳 | 对象的类型唯一的字母数字标识符。 上下文：view, edit,embed |
| status 细绳 | 对象的命名状态。 上下文: view,edit 其中之一：publish, future, draft, pending,private |
| type 细绳 | 对象的帖子类型。 只读 上下文：view, edit,embed |
| password 细绳 | 用于保护对内容和摘录的访问的密码。 语境：edit |
| permalink_template 细绳 | 对象的永久链接模板。 只读 语境：edit |
| generated_slug 细绳 | 从对象标题自动生成的 Slug。 只读 语境：edit |
| title 目的 | 对象的标题。 上下文：view, edit,embed |
| content 目的 | 对象的内容。 上下文: view,edit |
| author 整数 | 对象作者的 ID。 上下文：view, edit,embed |
| excerpt 目的 | 对象的摘录。 上下文：view, edit,embed |
| featured_media 整数 | 对象的特色媒体的 ID。 上下文：view, edit,embed |
| comment_status 细绳 | 对象上的注释是否打开。 上下文: view,edit 其中之一：open,closed |
| ping_status 细绳 | 是否可以 ping 对象。 上下文: view,edit 其中之一：open,closed |
| format 细绳 | 对象的格式。 上下文: view,edit 其中之一：standard,,,,,,,,,,, _ _ _ _ _ _asidechatgallerylinkimagequotestatusvideoaudio |
| meta 目的 | 元字段。 上下文: view,edit |
| sticky 布尔值 | 对象是否应被视为粘性。 上下文: view,edit |
| template 细绳 | 用于显示对象的主题文件。 上下文: view,edit |
| categories 大批 | 分配给类别分类法中对象的术语。 上下文: view,edit |
| tags 大批 | 分配给 post_tag 分类法中对象的术语。 上下文: view,edit |
列出帖子
查询此端点以检索帖子集合。可以使用下面的 URL 查询参数控制和过滤您收到的响应。
定义
GET /wp/v2/posts
示例请求
$ curl https://example.com/wp-json/wp/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 | Order 排序属性升序或降序。 默认：desc 其中之一：asc,desc |
| orderby | 按对象属性对集合进行排序。 默认：date 其中之一：author,,,,,,,,,,, _ _ _ _ _ _dateidincludemodifiedparentrelevancesluginclude_slugstitle |
| slug | 将结果集限制为具有一个或多个特定 slug 的帖子。 |
| status | 将结果集限制为分配了一种或多种状态的帖子。 默认：publish |
| tax_relation | 基于多个分类之间的关系限制结果集。 其中之一：AND,OR |
| categories | 将结果集限制为在类别分类法中分配了指定术语的所有项目。 |
| categories_exclude | 将结果集限制为所有项目，但在类别分类法中分配了指定术语的项目除外。 |
| tags | 将结果集限制为在标签分类法中分配了指定术语的所有项目。 |
| tags_exclude | 将结果集限制为所有项目，但在标签分类法中分配了指定术语的项目除外。 |
| 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 | 是否可以 ping 对象。 其中之一：open,closed |
| format | 对象的格式。 其中之一：standard,,,,,,,,,,, _ _ _ _ _ _asidechatgallerylinkimagequotestatusvideoaudio |
| meta | 元字段。 |
| sticky | 对象是否应被视为粘性。 |
| template | 用于显示对象的主题文件。 |
| categories | 分配给类别分类法中对象的术语。 |
| tags | 分配给 post_tag 分类法中对象的术语。 |
定义
POST /wp/v2/posts
检索帖子
定义和示例请求
GET /wp/v2/posts/<id>
查询此端点以检索特定的帖子记录。
$ curl https://example.com/wp-json/wp/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 | 是否可以 ping 对象。 其中之一：open,closed |
| format | 对象的格式。 其中之一：standard,,,,,,,,,,, _ _ _ _ _ _asidechatgallerylinkimagequotestatusvideoaudio |
| meta | 元字段。 |
| sticky | 对象是否应被视为粘性。 |
| template | 用于显示对象的主题文件。 |
| categories | 分配给类别分类法中对象的术语。 |
| tags | 分配给 post_tag 分类法中对象的术语。 |
定义
POST /wp/v2/posts/<id>
示例请求
$ curl -X POST https://example.com/wp-json/wp/v2/posts/<id> -d '{"title":"My New Title"}'
删除帖子
参数
| id | 对象的唯一标识符。 |
| force | 是否绕过回收站并强制删除。 |
定义
DELETE /wp/v2/posts/<id>
示例请求
$ curl -X DELETE https://example.com/wp-json/wp/v2/posts/<id>