通过手机号或邮箱获取用户 ID

POST

/contact/v3/users/batch_get_id

通过该接口，可使用手机号/邮箱获取用户的 ID 信息，具体获取支持的 ID 类型包括 open_id、user_id、union_id，可通过查询参数指定。
如果查询的手机号、邮箱不存在，或者无权限查看对应的用户，则返回的用户ID列表为空。

权限要求：
通过手机号或邮箱获取用户 ID
字段权限要求：
该接口返回体中存在下列敏感字段，仅当开启对应的权限后才会返回；如果无需获取这些字段，则不建议申请

获取用户 user ID

请求参数

Authorization

Bearer Token

在 Header 添加参数

Authorization

，其值为在 Bearer 之后拼接 Token

示例：

Authorization: Bearer ********************

Query 参数

Body 参数application/json

示例

返回响应

🟢200200 Success

application/json

Body

请求示例

Shell

JavaScript

Java

Swift

curl --location --request POST '/contact/v3/users/batch_get_id?user_id_type=open_id' \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data-raw '{
    "emails": [
"zhangsan@z.com","lisi@a.com"
    ],
    "mobiles": [
"13812345678","13812345679"
    ]
}'

响应示例

{
    "code": 0,
    "msg": "success",
    "data": {
        "user_list": [
            {
                "user_id": "ou_979112345678741d29069abcdef089d4",
                "email": "zhangsan@a.com"
            },
            {
                "user_id": "ou_919112245678741d29069abcdef096af",
                "email": "lisi@a.com"
            },
            {
                "user_id": "ou_46a087654321a1dc920ffab8fedc823f",
                "mobile": "13812345678"
            },
            {
                "user_id": "ou_01b081675121a1dc920ffab97cdc017a",
                "mobile": "13812345679"
            }
        ]
    }
}

修改于 2025-10-20 09:19:37

获取部门直属用户列表

资源介绍