用户添加标签
功能介绍
添加标签接口
调试
您可以在API Explorer中调试该接口,支持自动认证鉴权。API Explorer可以自动生成SDK代码示例,并提供SDK代码示例调试功能。
URI
POST /v1/tags
请求参数
参数 |
是否必选 |
参数类型 |
描述 |
---|---|---|---|
tag_name |
是 |
String |
标签名称 最小长度:1 最大长度:100 |
响应参数
状态码: 200
参数 |
参数类型 |
描述 |
---|---|---|
id |
Long |
标签标识 |
tag_name |
String |
标签名称 最大长度:100 |
status |
Integer |
标签状态,0未使用,1使用中。 |
状态码: 400
参数 |
参数类型 |
描述 |
---|---|---|
error_code |
String |
错误码 最大长度:64 |
error_msg |
String |
错误描述 最大长度:512 |
状态码: 500
参数 |
参数类型 |
描述 |
---|---|---|
error_code |
String |
错误码 最大长度:64 |
error_msg |
String |
错误描述 最大长度:512 |
请求示例
添加标签,新增的标签名为“新的标签名”。
POST https://{endpoint}/v1/tags { "tag_name" : "新增的标签名" }
响应示例
状态码: 400
Bad Request
-
示例 1
{ "error_code" : "GSL.00020004", "error_msg" : "参数异常" }
-
示例 2
{ "error_code" : "GSL.00022001", "error_msg" : "标签名称不合法,请检查!" }
-
示例 3
{ "error_code" : "GSL.00022002", "error_msg" : "标签名称已存在,请重新输入!" }
-
示例 4
{ "error_code" : "GSL.00022003", "error_msg" : "登录用户最多可以创建10000个标签。" }
-
示例 5
{ "error_code" : "GSL.00022004", "error_msg" : "登录用户没有标签的访问权限。" }
状态码: 500
Internal Server Error
{ "error_code" : "GSL.00020003", "error_msg" : "系统繁忙,请稍后重试。" }
状态码
状态码 |
描述 |
---|---|
200 |
OK |
400 |
Bad Request |
500 |
Internal Server Error |
错误码
请参见错误码。