智慧硬件开发
智慧硬件开发
硬件云端接入
设备接入
接口调用
获取设备管理二维码
获取设备管理二维码
最后更新:2024/03/26

获取设备管理二维码,设备管理二维码用于企业用户扫码进入设备管理菜单。url格式如下:
静态管理二维码:
https://open.work.weixin.qq.com/connect/hardware?type=static_login&login_code=qqq&state=xxx

请求方式:POST(HTTPS
请求地址:https://qyapi.weixin.qq.com/cgi-bin/openhw/device/gen_login_qrcode?device_access_token=DEVICE_ACCESS_TOKEN
请求包体:

{
    "state":"xxx1",
    "type":0
}

参数说明:

参数名类型描述
statestring扫码后下发扫码事件透传给设备的state值
typeuint32二维码类型,0 静态二维码 1 动态二维码

 

回包

{
    "errcode":0,
    "errmsg":"ok",
    "qrcode_content":"https://open.work.weixin.qq.com/connect/hardware?type=static_login&login_code=qqq&state=xxx1"
}

参数说明:

参数名类型描述
errcodeuint32错误报错码
errmsgstring错误报错信息
qrcode_contentstring静态设备管理二维码url。请将url生成二维码, 扫码使用
注意
静态二维码调用频率限制为针对设备sn级别 1次/min

 

动态管理二维码:
https://open.work.weixin.qq.com/connect/hardware?sn=xx&timestamp=1672381950&signature=xxxxxxxxx&type=dynamic_login&state=xxx

请求方式:POST(HTTPS
请求地址:https://qyapi.weixin.qq.com/cgi-bin/openhw/device/gen_login_qrcode?device_access_token=DEVICE_ACCESS_TOKEN
请求包体:

{
    "state":"xxx2",
    "type":1
}

参数说明:

参数名类型描述
statestring扫码后下发扫码事件透传给设备的state值
typeuint32二维码类型,0 静态二维码 1 动态二维码

 

回包

{
    "errcode":0,
    "errmsg":"ok",
    "qrcode_content":"https://open.work.weixin.qq.com/connect/hardware?sn=xx&timestamp=1672390043&signature=xxxxxx&type=dynamic_login&state=xxx2",
    "expires_in":300
}

参数说明:

参数名类型描述
errcodeuint32错误报错码
errmsgstring错误报错信息
qrcode_contentstring动态设备管理二维码url。请将url生成二维码, 扫码使用
expires_inuint32二维码有效时间,这里固定5min 300s ,5min后动态二维码过期
动态二维码调用频率限制为针对设备sn级别 1次/min,与获取身份识别二维码共享同一调用频率限制
频率调用限制静态二维码与动态二维码互不影响
上一篇上报设备固件升级结果
下一篇获取设备身份识别二维码
    本节内容
硬件直连接入
更新日志
联系我们