通过员工工号获取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 系统错误

result. ""

    Not Found. ""