根据unionid获取用户userid
更新于 2024-02-27调用本接口根据unionid获取用户的userid。
unionid是员工在当前开发者企业账号范围内的唯一标识，由系统生成：
同一个企业员工，在不同的开发者企业账号下，unionid是不相同的。
在同一个开发者企业账号下，unionid是唯一且不变的，例如同一个服务商开发的多个应用，或者是扫码登录等场景的多个App账号。
权限
服务端API是以应用维度授权的，在调用接口前，确保已经为应用添加了接口权限。
基本信息
请求方式：POST
请求地址：https://oapi.dingtalk.com/topapi/user/getbyunionid
Query参数
名称 | 类型 | 是否必填 | 示例值 | 描述 |
access_token | String | 是 | be3Fxxxx | 调用该接口的应用凭证。
|
Body参数
名称 | 类型 | 是否必填 | 示例值 | 描述 |
unionid | String | 是 | z21HjQliSzpw0Yxxxx | 员工在当前开发者企业账号范围内的唯一标识，系统生成，不会改变。
|
返回参数
名称 | 类型 | 示例值 | 描述 |
request_id | String | zcqi5450rpit | 请求ID。 |
errcode | Number | 0 | 返回码。 |
errmsg | String | ok | 返回码描述。 |
result | UserGetByUnionIdResponse | 返回结果。 | |
contact_type | Number | 0 | 联系类型：
|
userid | String | zhangsan | 用户的userid。 |
示例
请求示例（HTTP）
请求正文
请求示例（JAVA SDK）
返回示例
错误码
错误码（errcode） | 错误码描述（errmsg） | 解决方案 |
60121 | 未找到对应员工 | 请检查unionId是否正确 |
400002 | 无效的参数 | 请检查unionId是否正确 |
-1 | 系统繁忙 | 请稍后再试 |
