分类

最后更新于：2021-11-29 22:49:50

Categories

结构

结构定义了类别数据中存在的所有字段。除非使用“_filter”查询参数构造字段，否则来自这些端点的任何响应都可以包含以下字段。

id

integer 		唯一标识符。
只读
Context: view, embed, edit
count

integer 		此分类项的文章总数。
只读
Context: view, edit
description

string 		分类项的HTML描述。
Context: view, edit
link

string,
uri		分类项的URL。
只读
Context: view, embed, edit
name

string 		分类项的HTML标题。
Context: view, embed, edit
slug

string 		字母数字标识符，其类型是唯一的。
Context: view, embed, edit
taxonomy

string 		分类项的分类类型。
只读
Context: view, embed, edit
唯一: category, post_tag, nav_menu, link_category, post_format
parent

integer 		父项ID。
Context: view, edit
meta

object 		元字段。
Context: view, edit

分类集合

评论

定义

GET /gc/v2/categories

请求示例

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

参数

context提交请求的数据结构；明确响应字段结构。
默认: view
唯一: view, embed, edit
page集合的分页页码
默认: 1
per_page返回结果集的最大条数。
默认: 10
search字符串匹配的结果集。
exclude确保结果集排除特定ID。
include将结果集限制为特定ID。
order排序属性升序或降序。
默认: asc
唯一: asc, desc
orderby按分类项属性对集合排序。
默认: name
唯一: id, include, name, slug, include_slugs, term_group, description, count
hide_emptyWhether to hide terms not assigned to any posts.
parentLimit result set to terms assigned to a specific parent.
postLimit result set to terms assigned to a specific post.
slugLimit result set to terms with one or more specific slugs.

创建分类

参数

description分类项的HTML描述。
name分类项的HTML标题。Required: 1
slug字母数字标识符，其类型是唯一的。
parent父项ID。
meta元字段。

定义

POST /gc/v2/categories

检索分类

定义 & 请求示例

GET /gc/v2/categories/<id>

查询此端点以检索特定类别数据。

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

参数

id唯一标识符。
context提交请求的数据结构；明确响应字段结构。
默认: view
唯一: view, embed, edit

修改分类

参数

id唯一标识符。
description分类项的HTML描述。
name分类项的HTML标题。
slug字母数字标识符，其类型是唯一的。
parent父项ID。
meta元字段。

定义

POST /gc/v2/categories/<id>

请求示例

删除分类

参数

id唯一标识符。
force设置为true，表示不支持垃圾处理。

定义

DELETE /gc/v2/categories/<id>

请求示例

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