API开发文档 - 道一云

开发说明

开发说明

功能说明：新增部门
请求方式：POST（HTTPS）multipart/form-data
请求地址：https://qwif.do1.com.cn/qwcgi/api/deptAPI/addDepart.do?token=token&corpId=corpId

请求包体：

参数：deptInfo
{
    "departmentName": "部门ccc",
    "parentDepart": "6e41b48c4272122fbeabe6a62b2c3684",
    "showOrder":  "1",
    "permission":"3",
    "receiveWxUserId": "qy_15906191328|khh666"
}

请求参数说明：

参数名	释义	类型	是否必须
departmentName	部门名称	String	是
parentDepart	所属的父部门的id	String	否
showOrder	部门排序号	String	否
permission	可见权限： 1：全公司（可以看到全公司通讯录） 2：仅本部门（可以看到同一部门下所有子组织通讯录） 3：仅子部门（可以看到所在子部门及下属子组织通讯录）	String	否
receiveWxUserId	部门负责人账号，多个负责人请以"\|"进行分割	String	否

可见权限： 1：全公司（可以看到全公司通讯录） 2：仅本部门（可以看到同一部门下所有子组织通讯录） 3：仅子部门（可以看到所在子部门及下属子组织通讯录）

SDK调用示例：

		InterfaceDept deptInfo = new InterfaceDept();
		// 部门名称
		deptInfo.setDepartmentName("企小微");
		// 父级部门编号(顶级部门此字段为空)
		deptInfo.setParentDepart("");
		// 显示顺序
		deptInfo.setShowOrder(1);
		// 可见权限 1：全公司（可以看到全公司通讯录） 2：仅本部门（可以看到同一部门下所有子组织通讯录）
		// 3：仅子部门（可以看到所在子部门及下属子组织通讯录）
		deptInfo.setPermission("3");
		// 部门负责人账号，多个负责人以" |"进行分割
		deptInfo.setReceiveWxUserId("qy_15906191328|khh666");
		DeptApi deptApi = QwSdkUtil.getInter(DeptApi.class);
		ApiDeptResultVO depart = deptApi.addDepart(QwSdkUtil.getCacheToken(),
				deptInfo);
		System.out.println(JSONUtil.stringify(depart));

返回结果：

{
    "code":"0",
    "desc":"成功",
    "data":{
        "depart":{
            "departmentName":"部门bbb",
            "deptFullName":"部门bbb",
            "id":"42e79809ebd4fc3635fb03eac3add901",
            "orgId":"b17efb43-292e-4cc9-ac5d-0b46bce059c4",
            "parentDepart":"",
            "permission":"1",
            "showOrder":1,
            "wxId":"413",
            "wxParentid":"1",
            "receiveWxUserId": "qy_15906191328|khh666"
        }
    }
}

返回参数说明：

参数	说明
id	部门ID
departmentName	部门名称
parentDepart	父部门编号（顶级部门此字段为空）
orgId	组织编号
deptFullName	部门全称“->”为层级分隔符
showOrder	显示顺序
wxId	微信编号
wxParentid	微信父部门编号
permission	可见权限： 1：全公司（可以看到全公司通讯录） 2：仅本部门（可以看到同一部门下所有子组织通讯录） 3：仅子部门（可以看到所在子部门及下属子组织通讯录）
receiveWxUserId	部门负责人账号，多个负责人以"\|"进行分割

企业微信

新增部门

开发说明