分类

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

Categories

结构

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

id

integer 
唯一标识符。
只读
Context: viewembededit
count

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

string 
分类项的HTML描述。
Context: viewedit
link

string,
uri
分类项的URL。
只读
Context: viewembededit
name

string 
分类项的HTML标题。
Context: viewembededit
slug

string 
字母数字标识符,其类型是唯一的。
Context: viewembededit
taxonomy

string 
分类项的分类类型。
只读
Context: viewembededit
唯一: categorypost_tagnav_menulink_categorypost_format
parent

integer 
父项ID。
Context: viewedit
meta

object 
元字段。
Context: viewedit

分类集合

评论

定义

GET /gc/v2/categories

请求示例

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

参数

context提交请求的数据结构;明确响应字段结构。
默认: view
唯一: viewembededit
page集合的分页页码
默认: 1
per_page返回结果集的最大条数。
默认: 10
search字符串匹配的结果集。
exclude确保结果集排除特定ID。
include将结果集限制为特定ID。
order排序属性升序或降序。
默认: asc
唯一: ascdesc
orderby按分类项属性对集合排序。
默认: name
唯一: idincludenamesluginclude_slugsterm_groupdescriptioncount
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
唯一: viewembededit

修改分类

参数

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>