使用GEWE框架进行个人微信收藏夹及标签管理（标签篇）适用于微信群管、社群管理

本文链接：https://blog.csdn.net/weixin_36648445/article/details/132364321

友情链接 geweapi.com 点击即可访问！

添加标签

简要描述：

添加自定义标签注意[name]

请求URL：

http://域名地址/api/label/add

请求方式：

POST

请求头：

Content-Type：application/json

参数：

参数名	必填	数据类型	说明
appid	是	string	设备id
name	是	string	标签名

返回数据：

参数名	数据类型	说明
ret	number	0：成功
msg	string	反馈信息
data	object
labelCount	number	标签个数
labelPairList	object	标签列表
labelName	object	标签名称
labelID	object	标签id

请求参数示例：

   {
       "appid": "wx_nScLwnZhfNmlQlL0npc71",
       "name": "加人",
   }

成功返回示例：

   {
        "ret": 0,
        "msg": "success",
        "data": {
            "BaseResponse": {
                "ret": 0,
                "errMsg": {}
            },
            "LabelCount": 1,
            "LabelPairList": {
                "labelName": "加人",
                "labelID": 17
            }
        }
    }

错误返回示例：

    {
        "ret": 0,
        "msg": "success",
        "data": {
            "BaseResponse": {
                "ret": -2,
                "errMsg": {
                    "string": "args error"
                }
            },
            "LabelCount": 0
        }
    }

删除标签

简要描述：

删除已添加的标签
注意[id]

请求URL：

http://域名地址/api/label/delete

请求方式：

POST

请求头：

Content-Type：application/json

参数：

参数名称	数据类型	必填	说明
appid	是	string	设备id
id	是	string	标签id

返回数据：

参数名	数据类型	说明
ret	number	0：成功
msg	string	反馈信息
data	object

请求参数示例：

   {
       "appid": "wx_nScLwnZhfNmlQlL0npc71",
       "id": 17,
   }

成功返回示例：

   {
        "ret": 0,
        "msg": "success",
        "data": {
            "BaseResponse": {
                "ret": 0,
                "errMsg": {}
            }
        }
    }

错误返回示例：

    {
        "ret": -1,
        "msg_err": "[wx_bpPSNW0kK0xYSM6ldubd]设备不存在或已离线"
    }

标签列表

简要描述：

获取所有标签

请求URL：

http://域名地址/api/label/list

请求方式：

POST

请求头：

Content-Type：application/json
X-GEWE-TOKEN: 后台获取

参数：

参数名	必填	数据类型	说明
appid	是	string	设备id

返回数据：

参数名	数据类型	说明
ret	number	0：成功
msg	string	反馈信息
data	object
labelCount	number	标签个数
labelPairList	object	标签列表
labelName	string	标签名
labelID	string	标签id

请求参数示例：

   {
       "appid": "wx_nScLwnZhfNmlQlL0npc71",
       "sync_key": "",
   }

成功返回示例：

   {
        "ret": 0,
        "msg": "success",
        "data": {
            "BaseResponse": {
                "ret": 0,
                "errMsg": {}
            },
            "labelCount": 5,
            "labelPairList": [
                {
                    "labelName": "前端",
                    "labelID": 2
                },
                {
                    "labelName": "朋友",
                    "labelID": 5
                },
                {
                    "labelName": "技术",
                    "labelID": 14
                },
                {
                    "labelName": "同学",
                    "labelID": 15
                },
                {
                    "labelName": "123",
                    "labelID": 16
                }
            ]
        }
    }

错误返回示例：

    {
        "ret": -1,
        "msg_err": "[wx_bpPSNW0kK0xYSM6ldubd]设备不存在或已离线"
    }

修改标签

简要描述：

修改标签下的联系人
注意结构

请求URL：

http://域名地址/api/label/modifylist

请求方式：

POST

请求头：

Content-Type：application/json

参数：

参数名称	数据类型	必填	说明
appid	是	string	设备id
id	是	string	标签id
to_wxid_list	是	array	联系人wxid

返回数据：

参数名	数据类型	说明
ret	number	0：成功
msg	string	反馈信息
data	object

请求参数示例：

   {
       "appid": "wx_nScLwnZhfNmlQlL0npc71",
       "id": 16,
       "to_wxid_list": [
           "wxid_4bxxxxxxxxxxx22"
       ],
   }

成功返回示例：

   {
        "ret": 0,
        "msg": "success",
        "data": {
            "BaseResponse": {
                "ret": 0,
                "errMsg": {}
            }
        }
    }

错误返回示例：

    {
        "ret": 0,
        "msg": "success",
        "data": {
            "BaseResponse": {
                "ret": -2,
                "errMsg": {
                    "string": "args error"
                }
            }
        }
    }

修改标签名

简要描述：

更改标签名称
注意参数

请求URL：

http://域名地址/api/label/modifyname

请求方式：

POST

请求头：

Content-Type：application/json

参数：

参数名称	数据类型	必填	说明
appid	是	string	设备id
id	是	number	标签id
name	是	string	标签名

返回数据：

参数名	数据类型	说明
ret	number	0：成功
msg	string	反馈信息
data	object

请求参数示例：

   {
       "appid": "wx_nScLwnZhfNmlQlL0npc71",
       "id": 16,
       "name": "加人",
   }

成功返回示例：

   {
        "ret": 0,
        "msg": "success",
        "data": {
            "BaseResponse": {
                "ret": 0,
                "errMsg": {}
            }
        }
    }

错误返回示例：

    {
        "ret": 0,
        "msg": "success",
        "data": {
            "BaseResponse": {
                "ret": -2,
                "errMsg": {
                    "string": "args error"
                }
            }
        }
    }