API开发文档 - 道一云

开发说明

开发说明

功能说明：修改标签
请求方式：POST（HTTPS）multipart/form-data
请求地址： https://qwif.do1.com.cn/qwcgi/api/tag/updateTag.do?token=token&corpId=corpId

请求包体：

wxTagId参数不为空时，推荐请求方式：
参数：data
{
    "wxTagId":"1086",
    "tagName":"标签1",
    "showNum":"234" ,
    "rang": "1",
    "status":"0"
}

wxTagId为空时的请求方式：
参数：data
{
    "id": "sfdf808937898287esfdf",
    "tagName":"标签1",
    "showNum":"234" ,
    "rang": "1",
    "status":"0"
}

请求参数说明：

参数	说明	类型	是否必须	备注
id	标签ID	string	是	推荐使用wxTagId作为标签唯一标识码管理标签
wxTagId	标签微信ID	string	是	无wxTagId时，可使用id作为标识码管理标签
tagName	标签名	string	否	标签名不可重复，长度不可大于32个字
showNum	排序号	string	否	0 - 2147483647 不能小于0
rang	使用范围 1.后台 3.手机端+后台 5.手机端	string	否	默认1.后台取值只可取 1，3，5
status	标签状态 1.启用 0.禁用	string	否	默认1.启用取值只可取 1，0

SDK调用示例：

		/**
		 * 根据wxTagId进行标签的编辑，推荐使用此方式
		 */
		InterfaceTag tag = new InterfaceTag();
		// 标签微信ID
		tag.setWxTagId("110");
		// 标签名称 名称不得大于32个字
		tag.setTagName("企微云1");
		// 标签排序号 排序号 1 - 2147483647 默认200
		tag.setShowNum(2);
		// 标签使用范围 1.后台 3.手机端+后台 5.手机端 默认1.后台
		tag.setRang(1);
		// 标签状态 1.启用 0.禁用 默认1.启用
		tag.setStatus(1);
		// 推荐使用此方法管理标签
		TagApi api = QwSdkUtil.getInter(TagApi.class);
		ApiTagResultVO result = api.updateTag(QwSdkUtil.getCacheToken(), tag);
		System.out.println(JSONUtil.stringify(result));

		/**
		 * 根据id进行标签的编辑，无wxTagId时使用此方式
		 */
		InterfaceTag tag2 = new InterfaceTag();
		// 标签ID
		tag2.setId("d497aa213test9dad920c58");
		// 标签名称 名称不得大于32个字
		tag2.setTagName("企微云2");
		// 标签排序号 排序号 1 - 2147483647 默认200
		tag2.setShowNum(2);
		// 标签使用范围 1.后台 3.手机端+后台 5.手机端 默认1.后台
		tag2.setRang(1);
		// 标签状态 1.启用 0.禁用 默认1.启用
		tag2.setStatus(1);
		// 无wxTagId时，使用id管理标签
		ApiTagResultVO result2 = api.updateTag(QwSdkUtil.getCacheToken(),tag2);
		System.out.println(JSONUtil.stringify(result2));

返回结果：

{
	"code":"0",
	"data":
	{
		"tagInfo":
		{
			"deptCount":"0",
			"id":"sfdf808937898287esfdf",
			"rang":"1",
			"showNum":"234",
			"status":"0",
			"tagName":"标签1",
			"userCount":"0",
			"wxTagId":"1086"
		}

	},
	"desc":"成功"
}

返回参数说明：

参数名	释义	类型
id	标签ID	string
wxTagId	标签微信ID	string
tagName	标签名	string
showNum	排序号	string
rang	使用范围1.后台 3.手机端+后台 5.手机端	string
status	标签状态 1.启用 0.禁用	string
userCount	标签用户数量	string
deptCount	标签部门数量	string

企业微信

修改标签

开发说明