跳到主要内容

通过邮箱或手机号获取成员userId

调用本接口,实现通过手机号或邮箱查询工作区内成员的userId


权限说明

「超管accessToken」和「权限组accessToken」都可以调用,「权限组accessToken」须具有通讯录权限。

请求

请求方式: GET

请求地址: https://api.qingflow.com/user/getId(公有云版本)

示例如下:

GET https://api.qingflow.com/user/getId

其他版本请求地址:

钉钉版本:https://api.ding.qingflow.com/user/getId

专有轻流:http(s)://xxx.xx(自有域名)/openApi/user/getId

2.1 参数说明(查询参数)

参数必须说明
mobile手机号
email邮箱(与手机号同时传入时, 会使用邮箱查询成员信息)

2.2 请求头(Header)

参数必须说明
accessToken调用接口凭证。获取方法请查看“获取OpenAPI accessToken”接口文档

返回

3.1 返回体

参数必含类型说明
errCodeint错误码,非0表示失败
errMsgstring错误描述
questionRelationsarray关联的设置,本接口可忽略
resultarray返回结果
areaCodestring地区码
emailstring邮箱, 只在使用邮箱查询时返回
mobilestring手机号, 只在使用手机号查询时返回
userIdistring用户userID

3.2 返回体示例

{
"errCode": 0,
"errMsg": null,
"questionRelations": [],
"result": [
{
"areaCode": "86",
"email": null,
"mobile": "18842034052",
"userId": "809142"
}
]
}

注意事项

存在同一手机号注册了多个账户的情况,届时数组内将返回多个对象。