# 获取机器人二维码

[异步回调] 该接口用于获取机器人的二维码信息。

请求方式:POST

请求地址:https://$basehost/gateway/qopen/GetRobotQrcode

body参数

{
    "robot_id_list": ["机器人id"],
    "robot_type": 2
}
字段 类型 必填 说明
robot_id_list array 机器人id列表,不可传空,最多支持传入100个
robot_type int 2: 扫码号

返回值:

{
    "data": {
        "serial_no": "xxxxxx",
        "fail_info_list": [
            {robot_id: "acc1",desc: "xxx"},
        ]
    },
    "errcode": 0,
    "errmsg": "",
    "hint": ""
}

返回说明

字段 类型 说明
errcode int 状态码,0为正常,非0代表错误
errmsg string 错误信息
data json json返回值
   data.serial_no string 请求序列号
   data.fail_info_list json json返回值
     data.fail_info_list.robot_id string 机器人编号
     data.fail_info_list.desc string 失败原因
hint string 请求日志ID

处理结果,异步返回值 encoding_content解密后的结构:

{
    "event_type": 40005,
    "serial_no": "",
    "err_code": 0,
    "err_msg": "success",
    "data": {
        "robot_qrcode": {
            "机器人id": "http://xxxx.png"
        }
    }
}

说明

字段 类型 说明
event_type int 事件类型,40005
serial_no string 操作序列号
err_code int 状态码,0为正常,非0代表错误
err_msg string 错误信息
robot_qrcode Object 机器人二维码对象,key为robot_id value为二维码地址,链接非永久有效,如长期使用,请下载后自行存储

完整请求示例:

curl -X POST \
  https://$basehost/gateway/qopen/GetRobotQrcode \
  -H 'Content-Type: application/json; charset=UTF-8' \
  -H 'Token: c2NdxDHKXIJ5j1zrhJeq2eJEHjh9xxx' \
  -d '{
    "robot_id_list": ["机器人id","机器人id"],
    "robot_type": 2
}'
最后更新时间: 2023/11/13 10:42:47