用户添加标签
功能介绍
添加标签接口
调试
您可以在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  | 
     
错误码
请参见错误码。