API开发文档 - 道一云

开发说明

开发说明

功能说明：新增标签，如果标签超过3000个，则不允许添加

标签唯一标识码参数有两个，id和wxTagId。

如果在企业微信app中安装了道一云的通讯录，则使用道一云API接口新增标签时会同步新增到企业微信侧，wxTagId不为空。

如果未安装道一云的通讯录，新增时道一云无权限同步新增到企业微信侧，wxTagId为空；这时可使用id为标识码管理标签。

推荐安装道一云通讯录，使用wxTagId作为唯一标识码调用道一云API接口管理标签，实现道一云和企业微信的标签数据同步。

请求方式：POST（HTTPS）multipart/form-data
请求地址： https://qwif.do1.com.cn/qwcgi/api/tag/addTag.do?token=token&corpId=corpId

请求包体：

参数：data
{
    "tagName":"标签1",
    "showNum":"234" ,
    "rang": "1",
    "status":"0"
}

请求参数说明：

参数名	释义	类型	是否必须	备注
tagName	标签名	string	是	标签名不可重复，长度不可大于32个字
showNum	排序号	string	否	0 - 2147483647，默认200 ，不能小于0
rang	使用范围 1.后台 3.手机端+后台 5.手机端	string	否	默认1.后台，取值只可取1，3，5
status	标签状态 1.启用 0.禁用	string	否	默认1.启用，取值只可取1，0

SDK调用示例：

		InterfaceTag tag = new InterfaceTag();
		// 标签名称 名称不得大于32个字
		tag.setTagName("道一");
		// 标签排序号 排序号 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.addTag(QwSdkUtil.getCacheToken(), tag);
		System.out.println(JSONUtil.stringify(result));

返回结果：

{
	"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