# 使用手机号或邮箱获取用户 ID

根据用户邮箱或手机号查询用户 open_id 和 user_id，支持批量查询。warning
- 该接口为历史版本，不再维护，请前往使用新版接口[通过手机号或邮箱获取用户 ID](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/contact-v3/user/batch_get_id)。
- 只能查询到应用可用性范围内的用户 ID，不在范围内的用户会表现为不存在。

## 请求

基本 |  
---|---
HTTP URL | https://open.feishu.cn/open-apis/user/v1/batch_get_id?emails=lisi@z.com&emails=wangwu@z.com&mobiles=13812345678&mobiles=%2b12126668888
HTTP Method | GET
权限要求<br>**调用该 API 所需的权限。开启其中任意一项权限即可调用** | 通过手机号或邮箱获取用户 ID
字段权限要求<br>**接口返回的部分字段受权限控制，开启字段权限才可获取对应字段数据；如无需获取这些字段，则无需开启。**<br>根据要获取的字段开启相应权限 | 获取用户 user ID<br>获取用户邮箱信息<br>获取用户手机号

### 请求头

名称 | 类型 | 必填 | 描述
---|---|---|---
Authorization | string | 是 | `tenant_access_token`<br>**值格式**："Bearer `access_token`"<br>**示例值**："Bearer t-7f1bcd13fc57d46bac21793a18e560"<br>[了解更多：如何选择与获取 access token](https://open.feishu.cn/document/uAjLw4CM/ugTN1YjL4UTN24CO1UjN/trouble-shooting/how-to-choose-which-type-of-token-to-use)
Content-Type | string | 是 | **固定值**："application/json; charset=utf-8"

### 查询参数
参数 | 类型 | 必填 / 选填 | 示例 | 说明
-- | -- | -- | -- | --
emails | string | 选填 | lisi@z.com | 要查询的用户邮箱，最多 50 条，多个邮箱以 & 隔开。
mobiles | string | 选填 | 13812345678<br>%2b12126668888 | 要查询的用户手机号，最多 50 条，多个手机号以 & 隔开。<br>非中国大陆地区的手机号需要添加以 “+” 开头的国家 / 地区代码，并且需要进行 URL 转义。<br>
## 响应
### 响应体
参数 | 说明
-- | --
code | 返回码，非 0 表示失败。
msg | 对返回码的文本描述。
data | -
&emsp;∟email_users | 根据邮箱查询到的用户，key 为邮箱，value 为查询到用户的 array。<br>目前同一个邮箱最多只能查询到一个用户。
&emsp;&emsp;∟open_id | 用户的 open_id。[open_id描述](https://open.feishu.cn/document/home/user-identity-introduction/open-id)
&emsp;&emsp;∟user_id | 用户的 user_id。<br>只有已申请 `获取用户UserID` 权限的企业自建应用返回此字段。[user_id描述](https://open.feishu.cn/document/home/user-identity-introduction/user-id)
&emsp;∟emails_not_exist | 没有匹配记录的邮箱。
&emsp;∟mobile_users | 根据手机号查询到的用户，key 为手机号，value 为查询到用户的 array。<br>目前同一个手机号最多只能查询到一个用户。
&emsp;∟mobiles_not_exist | 没有匹配记录的手机号。
### 响应体示例
```json
{
    "code": 0,
    "msg": "success",
    "data": {
        "email_users": {
            "lisi@z.com": [
                {
                    "open_id": "ou_979112345678741d29069abcdef089d4",
                    "user_id": "a7eb3abe"
                }
            ]
        },
        "emails_not_exist": [
            "wangwu@z.com"
        ],
        "mobile_users": {
            "13812345678": [
                {
                    "open_id": "ou_46a087654321a1dc920ffab8fedc823f",
                    "user_id": "18fg19d4"
                }
            ]
        },
        "mobiles_not_exist": [
            "13912345678",
            "+12126668888"
        ]
    }
}
```
### 错误码

具体可参考：[服务端错误码说明](https://open.feishu.cn/document/ukTMukTMukTM/ugjM14COyUjL4ITN)