API开发文档 - 道一云

开发说明

开发说明

功能说明：添加标签成员，如果标签成员数量大于30000，则不允许添加
请求方式：POST（HTTPS）multipart/form-data
请求地址： https://qwif.do1.com.cn/qwcgi/api/tag/addTagRef.do?token=token&corpId=corpId

请求包体：

有wxTagId时，推荐请求方式：
参数：data
{
	"wxTagId":"1008",
	"wxDeptIdList":
	[
		"1088",
		"1089"
	],
	"wxUserIdList":
	[
		"1086",
		"1087"
	]

}

无wxTagId时，使用此方式：
参数：data
{
	"id":"1dskmfhsdkljfsdklf32434rfrw",
	"wxDeptIdList":
	[
		"1088",
		"1089"
	],
	"wxUserIdList":
	[
		"1086",
		"1087"
	]

}

请求参数说明：

参数名	说明	类型	是否必须	备注
wxTagId	标签微信ID	string	是	推荐使用wxTagId作为标签唯一标识码管理标签
id	标签ID	string	是	无wxTagId时，可使用id作为标识码管理标签
wxUserIdList	用户微信账号列表	String[]	否	对应获取用户列表接口中的wxUserId字段，用户和部门账号列表不能同时为空
wxDeptIdList	部门账号列表	String[]	否	对应获取部门列表接口中的wxId字段，用户和部门账号列表不能同时为空

SDK调用示例：

		/**
		 * 根据wxTagId添加标签成员（人员和部门），推荐使用此方式
		 */
		TagRefVO vo = new TagRefVO();
		// 标签微信ID
		vo.setWxTagId("39");
		// 用户微信ID 需要传入字符串数组
		vo.setWxUserIdList(new String[]{"123","641","640"});
		// 部门微信ID 需要传入字符串数组
		vo.setWxDeptIdList(new String[]{"123","641","640"});
		TagApi api = QwSdkUtil.getInter(TagApi.class);
		ApiTagRefListResultVO result = api.addTagRef(QwSdkUtil.getCacheToken(), vo);
		System.out.println(JSONUtil.stringify(result));
		/**
		 * 根据id添加标签成员（人员和部门），无wxTagId时使用此方式
		 */
		TagRefVO refVO = new TagRefVO();
		// 标签ID
		refVO.setId("8d64d38138001380001ad9ab7625");
		// 用户微信ID 需要传入字符串数组
		refVO.setWxUserIdList(new String[]{"123","641","640"});
		// 部门微信ID 需要传入字符串数组
		refVO.setWxDeptIdList(new String[]{"123","641","640"});
		TagApi api2 = QwSdkUtil.getInter(TagApi.class);
		ApiTagRefListResultVO result2 = api2.addTagRef(QwSdkUtil.getCacheToken(), refVO);
		System.out.println(JSONUtil.stringify(result2));

返回结果：

正确时返回：
{
    "code": "0",
    "desc": "成功",
    "data": {}
}

部分人员，部门非法返回
{
    "code": "0",
    "desc": "成功",
    "data": {
        "invalidUserIdList": [ "1087" ],
        "invalidDeptIdList": [ "1089" ]
    }
}

全部人员和部门非法时，返回：
{
    "code": "5864",
    "desc": "所有人员和部门非法",
    "data": {
        "invalidUserIdList": [ "1086", "1087" ],
        "invalidDeptIdList": [ "1088", "1089" ]
    }
}

返回参数说明：

参数名	说明	类型
invalidUserIdList	无效的用户微信账号列表	String[]
invalidDeptIdList	无效的部门微信账号列表	String[]

企业微信

添加标签成员

开发说明