# 机器人获取安全验证码
登录后20-30分钟内可能会出现新设备验证,接收到 42073 事件后,在验证过期时间之前调用此接口获取安全验证码并使用企微移动端扫码完成验证,扫完码后,会接收到登录流程相关事件
请求方式:POST
请求地址:https://$basehost/gateway/qopen/GetRobotLoginVerifyQrcode
body参数:
{
"robot_id": "机器人id"
}
字段 | 类型 | 必填 | 说明 |
---|---|---|---|
robot_id | string | 是 | 机器人编号 |
返回值:
{
"data": {},
"errcode": 0,
"errmsg": ""
}
处理结果,异步返回值 encoding_content解密后的结构:
{
"event_type": 42074,
"data": {
"login_code_expire_time": "登陆码过期时间",
"login_code_url": "二次验证登录码",
"robot_id": "机器人id"
},
"err_code": 0,
"err_msg": "",
"hint": "xxxxxxx",
"robot_id": "机器人id",
"serial_no": ""
}
返回说明
字段 | 类型 | 说明 |
---|---|---|
errcode | int | 状态码,0为正常,非0代表错误 |
errmsg | string | 错误信息 |
event_type | int | 事件类型,42074 |
serial_no | string | 操作序列号 |
data | object | 返回数据 |
data.robot_id | string | 机器人id |
data.login_code_expire_time | int | 登陆码过期时间 |
data.login_code_url | string | 二次验证登录码 |
完整请求示例:
curl -X POST \
https://$basehost/gateway/qopen/GetRobotLoginVerifyQrcode \
-H 'Content-Type: application/json; charset=UTF-8' \
-H 'Token: c2NdxDHKXIJ5j1zrhJeq2eJEHjh9xxx' \
-d '{
"robot_id": "机器人id"
}'
← 获取机器人二维码 机器人重新验证手机号 →