时间:2021-04-19 15:53:59
调用前提:
此接口仅在企业微信3.1.6及以后版本支持,微信端不支持(微信开发者工具也不支持),仅支持ios,android和PC端调用
必须先调用过wx.qy.login,且session_key未过期,开发者可调用checkSession 检查当前登录态
打开企业互联/局校互联通讯录选人功能,仅返回应用可见范围内的成员和部门。
参数名 | 类型 | 必填 | 说明 |
---|---|---|---|
fromDepartmentId | Number | 是 | 表示打开的通讯录从指定的部门开始展示,-1表示打开的通讯录从自己所在部门开始展示, 0表示从最上层开始。移动端,当需要展开的部门不在应用可见范围内,则从应用的可见范围开始展开。 |
mode | String | 是 | 选择模式,”single”表示单选,”multi”表示多选 |
type | Array | 是 | 选择限制类型,指定”department”、”user”中的一个或者多个 |
selectedDepartmentIds | Array | 否 | 已选部门ID列表。用于多次选人时可重入 |
selectedUserIds | Array | 否 | 已选用户ID列表,仅自建应用使用,企业微信会忽略第三方应用填入的该字段。用于多次选人时可重入 |
selectedOpenUserIds | Array | 否 | 已选用户ID列表,仅第三方应用使用,企业微信会忽略自建应用填入的该字段。用于多次选人时可重入 |
selectedCorpGroupDepartmentIds | Array | 否 | 已选企业互联部门ID列表。用于多次选人时可重入 |
selectedCorpGroupDepartmentIds.corpId | String | 是 | 已选企业互联的CorpId |
selectedCorpGroupDepartmentIds.departmentId | String | 是 | 已选企业互联的部门ID |
selectedCorpGroupUserIds | Array | 否 | 已选企业互联用户ID列表。用于多次选人时可重入 |
selectedCorpGroupUserIds.corpId | String | 是 | 已选企业互联的CorpId |
selectedCorpGroupUserIds.userId | String | 是 | 已选企业互联的用户userId,自建应用必填,企业微信会忽略第三方应用填入的该字段 |
selectedCorpGroupUserIds.openUserId | String | 是 | 已选企业互联的用户openUserId,第三方应用必填,企业微信会忽略自建应用填入的该字段。 |
success | Function | 否 | 接口调用成功的回调函数 |
fail | Function | 否 | 接口调用失败的回调函数 |
complete | Function | 否 | 接口调用结束的回调函数(调用成功、失败都会执行) |
参数
Object res.result
参数 | 类型 | 说明 |
---|---|---|
departmentList | Array | 已选的部门列表 |
departmentList.id | String | 已选的部门Id |
userList | Array | 已选的成员列表 |
userList.id | String | 已选的成员userId, 仅自建应用返回 |
userList.openUserId | String | 已选的成员userId, 仅第三方应用返回 |
corpGroupDepartmentList | Array | 已选企业互联部门ID列表 |
corpGroupDepartmentList.corpId | String | 已选企业互联企业corpId |
corpGroupDepartmentList.id | String | 已选企业互联企业部门Id |
corpGroupUserList | Array | 已选企业互联用户ID列表 |
corpGroupUserList.corpId | String | 已选企业互联企业corpId |
corpGroupUserList.id | String | 已选企业互联企业成员userId, 仅自建应用返回 |
corpGroupUserList.openUserId | String | 已选企业互联企业成员openUserId,仅第三方应用使用返回 |
Object res.errMsg
参数 | 说明 |
---|---|
selectCorpGroupContact:ok | 执行成功 |
selectCorpGroupContact:fail no permission | 必须先调用过wx.qy.login,且session_key未过期 |