类别
图式
该模式定义了类别记录中存在的所有字段。除非使用“_filter”查询参数或模式字段仅出现在特定上下文中，否则来自这些端点的任何响应都应包含以下字段。
| id 整数 | 术语的唯一标识符。 只读 上下文：view, embed,edit |
| count 整数 | 该术语的已发布帖子数。 只读 上下文: view,edit |
| description 细绳 | 术语的 HTML 描述。 上下文: view,edit |
| link 字符串， uri | 术语的 URL。 只读 上下文：view, embed,edit |
| name 细绳 | 术语的 HTML 标题。 上下文：view, embed,edit |
| slug 细绳 | 术语的唯一类型的字母数字标识符。 上下文：view, embed,edit |
| taxonomy 细绳 | 为术语键入属性。 只读 上下文：view, embed,edit 其中之一：category, post_tag, nav_menu, link_category,post_format |
| parent 整数 | 父术语 ID。 上下文: view,edit |
| meta 目的 | 元字段。 上下文: view,edit |
列出类别
查询此端点以检索类别集合。可以使用下面的 URL 查询参数控制和过滤您收到的响应。
定义
GET /wp/v2/categories
示例请求
$ curl https://example.com/wp-json/wp/v2/categories
参数
| context | 提出请求的范围；确定响应中存在的字段。 默认：view 其中之一：view, embed,edit |
| page | 集合的当前页面。 默认：1 |
| per_page | 结果集中要返回的最大项目数。 默认：10 |
| search | 将结果限制为与字符串匹配的结果。 |
| exclude | 确保结果集排除特定 ID。 |
| include | 将结果集限制为特定 ID。 |
| order | Order 排序属性升序或降序。 默认：asc 其中之一：asc,desc |
| orderby | 按术语属性对集合进行排序。 默认：name 其中 之一：id,,,,,,,,, include_ name_ _ _sluginclude_slugsterm_groupdescriptioncount |
| hide_empty | 是否隐藏未分配给任何帖子的术语。 |
| parent | 将结果集限制为分配给特定父项的术语。 |
| post | 将结果集限制为分配给特定帖子的术语。 |
| slug | 将结果集限制为具有一个或多个特定 slug 的术语。 |
创建类别
参数
| description | 术语的 HTML 描述。 |
| name | 术语的 HTML 标题。 要求：1 |
| slug | 术语的唯一类型的字母数字标识符。 |
| parent | 父术语 ID。 |
| meta | 元字段。 |
定义
POST /wp/v2/categories
检索类别
定义和示例请求
GET /wp/v2/categories/<id>
查询此端点以检索特定类别记录。
$ curl https://example.com/wp-json/wp/v2/categories/<id>
参数
| id | 术语的唯一标识符。 |
| context | 提出请求的范围；确定响应中存在的字段。 默认：view 其中之一：view, embed,edit |
更新类别
参数
| id | 术语的唯一标识符。 |
| description | 术语的 HTML 描述。 |
| name | 术语的 HTML 标题。 |
| slug | 术语的唯一类型的字母数字标识符。 |
| parent | 父术语 ID。 |
| meta | 元字段。 |
定义
POST /wp/v2/categories/<id>
示例请求
删除类别
参数
| id | 术语的唯一标识符。 |
| force | 要求为真，因为术语不支持丢弃。 |
定义
DELETE /wp/v2/categories/<id>
示例请求
$ curl -X DELETE https://example.com/wp-json/wp/v2/categories/<id>