通过员工工号获取userId
通过员工工号corpuserId获取用户的唯一标识,该接口依赖开户时需要设定员工的企业工号,否则WeLink系统中该字段为空,无法查询userId。
请求格式说明
请求方式: POST(HTTPS)
请求地址: https://open.welink.huaweicloud.com/api/contact/v1/users/accounts
认证方式: access_token,请参考获取access_token。
请求头部:
x-wlk-Authorization: access_token
Content-Type: application/json
请求参数:
{
"corpUserId": ["zhangsan", "lisi"]
}
请求参数说明:
参数 | 参数类型 | 必填 | 说明 |
---|---|---|---|
corpUserId | List | 是 | corpUserId列表(多个id用“,”分隔,最多支持50个一次) |
请求示例:
curl -X POST \
https://open.welink.huaweicloud.com/api/contact/v1/users/accounts \
-H 'Content-Type: application/json' \
-H 'x-wlk-Authorization: access_token' \
-d '{
"corpUserId": ["zhangsan", "lisi"]
}'
响应格式说明
返回结果:
{
"code":"0",
"message":"OK",
"userInfo":[
{
"userId":"zhangsan@welink",
"corpUserId":"zhangsan"
},
{
"userId":"lisi@welink",
"corpUserId":"lisi"
}
]
}
返回参数说明:
参数 | 说明 |
---|---|
code | 数据正常返回“0”,如果发生错误,会返回对应的错误码。 |
message | 返回信息,包括接口请求发生错误时的详细信息。 |
userInfo | 用户信息 |
userId | 用户帐号 |
corpUserId | 第三方集成帐号(员工工号) |
错误码说明:
错误码 | 说明 |
---|---|
47001 | 当前登录用户信息获取失败 |
47003 | 参数为空 |
47012 | 无数据 |
47013 | 查询数量限制 |
500 | 系统错误 |