标签

最后更新于：2021-11-29 21:56:15

Tags

结构

结构定义了标签数据中存在的所有字段。除非使用“_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
meta

object 		元字段。
Context: view, edit

标签列表

查询此端点以检索标签集合。您可以使用下面的URL查询参数来控制和过滤您收到的响应。

定义

GET /gc/v2/tags

请求示例

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

参数

context提交请求的数据结构；明确响应字段结构。
默认: view
唯一: view, embed, edit
page集合的分页页码
默认: 1
per_page返回结果集的最大条数。
默认: 10
search字符串匹配的结果集。
exclude确保结果集排除特定ID。
include将结果集限制为特定ID。
offset将结果集偏移特定数量的项。
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.
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字母数字标识符，其类型是唯一的。
meta元字段。

定义

POST /gc/v2/tags

检索单个标签

定义 & 请求示例

GET /gc/v2/tags/<id>

查询此端点以检索特定的标记数据。

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

参数

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

修改单个标签

参数

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

定义

POST /gc/v2/tags/<id>

请求示例

删除单个标签

参数

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

定义

DELETE /gc/v2/tags/<id>

请求示例

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