通过邮箱或手机号获取成员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 | 手机号 | |
| 邮箱(与手机号同时传入时, 会使用邮箱查询成员信息) |
2.2 请求头(Header)
| 参数 | 必须 | 说明 |
|---|---|---|
| accessToken | 是 | 调用接口凭证。获取方法请查看“获取OpenAPI accessToken”接口文档 |
返回
3.1 返回体
| 参数 | 必含 | 类型 | 说明 |
|---|---|---|---|
| errCode | 是 | int | 错误码,非0表示失败 |
| errMsg | 是 | string | 错误描述 |
| questionRelations | 是 | array | 关联的设置,本接口可忽略 |
| result | 是 | array | 返回结果 |
| areaCode | 是 | string | 地区码 |
| string | 邮箱, 只在使用邮箱查询时返回 | ||
| mobile | string | 手机号, 只在使用手机号查询时返回 | |
| userId | 是 | istring | 用户userID |
3.2 返回体示例
{
"errCode": 0,
"errMsg": null,
"questionRelations": [],
"result": [
{
"areaCode": "86",
"email": null,
"mobile": "18842034052",
"userId": "809142"
}
]
}
注意事项
存在同一手机号注册了多个账户的情况,届时数组内将返回多个对象。