# 机器人获取安全验证码

登录后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"
}'
最后更新时间: 2024/1/31 16:29:56