获取用户验证链接

最近更新时间:2024-07-22 10:29:21

我的收藏

接口描述

描述:
未验证的账号,可以获取验证链接,验证链接有效期是48h,每次获取链接为一个新链接,账号信息不变,旧链接仍然48h有效。
如果没有绑定手机号,不支持调用。
每个 userid 每天可获取10次验证链接。
鉴权方式:JWT
请求方式:POST
自建应用权限点:管理企业用户。
接口请求域名
https://api.meeting.qq.com/v1/users/invite-auth

输入参数

参数名称
必选
参数类型
参数描述
userid_list
Array
未验证 userid 列表,最多一次支持传20个。
operator_id_type
Integer
操作者 ID 的类型:
1:userid
operator_id
String
操作者 ID。operator_id 必须与 operator_id_type 配合使用。根据 operator_id_type 的值,operator_id 代表不同类型。

输出参数

参数名称
参数类型
参数描述
auth_user_list
AuthUser 对象数组
未验证用户对象列表。
error_user_list
ErrorUser 对象数组
获取验证链接失败的列表。

AuthUser 对象

参数名称
参数类型
参数描述
userid
String
账号 ID。
auth_url
String
验证链接。

ErrorUser 对象

参数名称
参数类型
参数描述
userid
String
账号 ID。
error_code
String
错误码。
error_msg
String
错误描述。

错误码列表

状态码
错误码
错误描述
400
20001
用户不存在。
400
190004
参数非法,请对照接口文档检查您的参数。
400
500120
该用户未激活,无法验证。
400
500091
无权限进行该操作,建议检查操作者身份或资源归属。
400
500121
用户未绑定手机号。
400
500035
您已触发上限,请明日再试。

示例

输入示例

POST
https://api.meeting.qq.com/v1/users/invite-auth
{
"operator_id_type":1
"operator_id":"xxxxxxxx",
"userid_list":
[
"user1",
"user2",
"user3"
]
}

输出示例

{
"auth_user_list": [{
"userid": "user1",
"auth_url": "https://meeting.tencent.com/corporate-invitation/activation.html?code=12345678"
},
{
"userid": "user2",
"auth_url": "https://meeting.tencent.com/corporate-invitation/activation.html?code=12345678"
}
],
"error_user_list":[{
"userid":"user3",
"error_code":"20001",
"error_msg":"用户不存在"
}]
}