友情链接 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"}}}}