查询人员信息同步结果
查询人员信息同步结果。
请求格式说明
请求方式:POST (HTTPS)
请求地址:
https://open.welink.huaweicloud.com/api/contact/v1/users/status
认证方式: access_token,请参考获取access_token。
请求头部:
Accept-Charset:UTF-8
Content-Type:application/json
x-wlk-Authorization:access_token
请求参数:
{
"personInfo": [
{
"corpUserId": "111"
},
{
"mobileNumber": "186xxxxxxxx"
}
]
}
请求参数说明:
参数 | 参数类型 | 必填 | 说明 |
---|---|---|---|
corpUserId | String | 特殊可选 | 用户在客户系统的唯一标示。corpUserId、mobileNumber和userEmail不可同时为空 |
mobileNumble | String | 特殊可选 | 手机号码。corpUserId、mobileNumber和userEmail不可同时为空 |
userEmail | String | 特殊可选 | 邮箱。corpUserId、mobileNumber和userEmail不可同时为空 |
请求示例:
curl -X POST \
'https://open.welink.huaweicloud.com/api/contact/v1/users/status' \
-H 'Accept-Charset: UTF-8' \
-H 'Content-Type: application/json' \
-H 'x-wlk-Authorization: access_token' \
-d '{"请求参数 json格式"}'
响应格式说明
返回结果:
正常返回结果:
{
"code": "0",
"message": "success",
"data": [
{
"corpUserId": "xxxxx",
"code": "47107",
"message": " No need to operate, just save into the admin table"
},
{
"corpUserId": "xxxxx",
"code": "47109",
"message": " Operation success"
},
{
"corpUserId": "xxxxx",
"code": "47110",
"message": " Failed to get the company email suffix information."
},
{
"corpUserId": "xxxxx",
"code": "47111",
"message": " Account not exist."
}
]
}
异常返回结果:
{
"code": "47103",
"message": "Authentication failed",
"data": []
}
返回参数说明:
参数 | 说明 |
---|---|
code | 数据正常返回“0”,如果发生错误,会返回对应的错误码。 |
message | 返回信息,包括接口请求发生错误时的详细信息。 |
data | corpUserId:用户唯一标示; code:状态码; message:状态描述 |
错误码
错误码 | 说明 |
---|---|
0 | 成功 |
47003 | 参数为空(邮箱不能为空,部门信息不能为空等) |
47004 | 参数不对(邮箱格式有误,手机号码有误等) |
47100 | 待处理 |
47101 | Token格式错误 |
47102 | 无权限 |
47103 | Token过期 |
47104 | 处理中 |
47105 | 秘书帐号未创建 |
47106 | 上级部门未创建 |
47107 | 对应provider回写的状态1:未开户(仅保存成功) |
47108 | 对应provider回写的状态2:开户中 |
47109 | 对应provider回写的状态3:开户成功 |
47110 | 对应provider回写的状态4:开户失败(携带失败原因) |
47111 | 对应provider回写的状态-1:账户不存在 |
47112 | 处理中(无须再提交此数据) |
47113 | 待处理(无须再提交此数据) |