标签推送

获取access_token

创建标签

更新标签名字

删除标签

获取标签成员

增加标签成员

删除标签成员

获取标签列表

应用端（与SID对接的应用）开发人员需实现标签推送相关接口，与SID进行节点同步。

标签推送接口调用步骤：

获取access_token—>携带access_token调用标签推送接口

获取access_token

access_token是SID后台去应用端的后台获取信息时的重要票据，由corpid和secret产生。所有接口在通信时都需要携带此信息用于验证接口的访问权限。

应用端开发人员向锐捷开发人员索要获取corpid和secret。

请求⽅式：GET（HTTPS或HTTP）

请求地址：http://{server}/cgi-bin/gettoken?corpid=ID&corpsecret=SECRET

注：（1）此处标注大写的单词ID和SECRET，为需要替换的变量，根据实际获取值更新。其它接口也采用相同的标注，不再说明；

（2）https方式类似。

参数说明：

返回结果：

{
   "errcode":0,
   "errmsg":"",
   "access_token": "accesstoken000001",
   "expires_in": 7200
}

参数说明：

出错返回示例：

{
   "errcode":40091,
   "errmsg":"secret is invalid"
}

特别说明：

标签推送的所有接口，返回包里都有errcode、errmsg。errcode为0时代表调用成功。 而errmsg仅作参考，后续可能会有变动，因此不可作为是否调用成功的判据。 后面不再赘述。

创建标签

请求⽅式：POST（HTTPS或HTTP）

请求地址：http://{server}/app/tag/create?access_token=ACCESS_TOKEN

注：https方式类似。

请求头:

header: Content-Type: application/json

请求参数：

{
    "tagname": "UI", 
    "tagid": 12
}

参数说明：

权限说明： 创建的标签属于该应用，只有该应用的secret才可以增删成员。 注意，标签总数不能超过3000个。

返回结果：

{
    "errcode": 0,
    "errmsg": "created",
    "tagid": 12
}

参数说明：

更新标签名字

请求⽅式：POST（HTTPS或HTTP）

请求地址：http://{server}/app/tag/update?access_token=ACCESS_TOKEN

注：https方式类似。

请求头:

header: Content-Type: application/json

请求参数：

{
    "tagid": 12,
    "tagname": "UI design"
}

参数说明：

权限说明： 调用的应用必须是指定标签的创建者。

返回结果：

{
   "errcode": 0, 
   "errmsg": "updated"
}

参数说明：

删除标签

请求⽅式：GET（HTTPS或HTTP）

请求地址：http://{server}/app/tag/delete?access_token=ACCESS_TOKEN&tagid=TAGID

注：https方式类似。

参数说明：

权限说明： 调用的应用必须是指定标签的创建者。

返回结果：

{
    "errcode": 0,
    "errmsg": "deleted"
}

参数说明：

获取标签成员

请求⽅式：GET（HTTPS或HTTP）

请求地址：http://{server}/app/tag/get?access_token=ACCESS_TOKEN&tagid=TAGID

注：https方式类似。

参数说明：

权限说明： 无限制，但返回列表仅包含应用可见范围的成员。

返回结果：

{
    "errcode": 0,
    "errmsg": "ok",
    "tagname": "乒乓球协会", 
    "userlist": [ 
        { 
            "userid": "zhangsan", 
            "name": "李四" 
        } 
       ], 
   "partylist": [2]
}

参数说明：

增加标签成员

请求⽅式：POST（HTTPS或HTTP）

请求地址：http://{server}/app/tag/addtagusers?access_token=ACCESS_TOKEN

注：https方式类似。

请求头:

header: Content-Type: application/json

请求参数：

{
    "tagid": 12, 
    "userlist":["user1","user2"],
    "partylist": [4]
}

参数说明：

权限说明： 调用的应用必须是指定标签的创建者；成员属于应用的可见范围。 注意，每个标签下部门、人员总数不能超过3万个。

返回结果：

a)正确时返回

{
    "errcode": 0,
    "errmsg": "ok"
}

b)若部分userid、partylist非法，则返回

{
    "errcode": 0, 
    "errmsg": "ok",
    "invalidlist"："usr1|usr2|usr",
    "invalidparty"：[2,4]
}

c)当包含userid、partylist全部非法时返回

{
    "errcode": 40070,
    "errmsg": "all list invalid"
}

参数说明：

删除标签成员

请求⽅式：POST（HTTPS或HTTP）

请求地址：http://{server}/app/tag/deltagusers?access_token=ACCESS_TOKEN

注：https方式类似。

请求头:

header: Content-Type: application/json

请求参数：

{
    "tagid": 12, 
    "userlist":[ "user1","user2"],
    "partylist": [2,4]
}

参数说明：

权限说明： 调用的应用必须是指定标签的创建者；成员属于应用的可见范围。

返回结果：

a)正确时返回

{
    "errcode": 0,
    "errmsg": "deleted"
}

b)若部分userid、partylist非法，则返回

{
    "errcode": 0, 
    "errmsg": "deleted",
    "invalidlist"："usr1|usr2|usr",
    "invalidparty"：[2,4]
}

c)当包含userid、partylist全部非法时返回

{
    "errcode": 40031,
    "errmsg": "all list invalid"
}

参数说明：

获取标签列表

请求⽅式：GET（HTTPS或HTTP）

请求地址：http://{server}/app/tag/list?access_token=ACCESS_TOKEN

注：https方式类似。

参数说明：

权限说明： 调用的应用必须是指定标签的创建者；成员属于应用的可见范围。

返回结果：

{
   "errcode": 0, 
   "errmsg": "ok", 
   "taglist":[
       {"tagid":1,"tagname":"a"}, 
       {"tagid":2,"tagname":"b"} 
       ]
}

参数说明：