接口描述
描述:
未验证的账号,可以获取验证链接,验证链接有效期是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 | 您已触发上限,请明日再试。 |
示例
输入示例
POSThttps://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":"用户不存在"}]}