智慧硬件开发 硬件云端接入 设备接入 接口调用 获取设备身份识别二维码
获取设备身份识别二维码
最后更新:2024/03/26
可联系渠道经理采购或代理智慧硬件接口已支持设备 联系渠道经理
获取设备身份识别二维码
最后更新:2024/03/26

获取设备身份识别二维码,身份识别二维码用于企业用户扫码绑定设备到企业、扫码跳转设备详情页,打印机扫码打印等。url格式如下:
静态身份识别二维码:
https://open.work.weixin.qq.com/connect/hardware?hw_code=xxx
获取方式详见文档 获取设备详情 回包 qr_code字段

动态身份识别二维码:
https://open.work.weixin.qq.com/connect/hardware?sn=xx&timestamp=1672382444&signature=xxxxxxxxx&type=qrcode&state=xxx2

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

{
    "device_sn":"xx",
    "state":"xxx2"
}

参数说明:

参数名类型描述
device_snstring设备sn编码
statestring扫码后下发扫码事件透传给设备的state值

 

回包

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

参数说明:

参数名类型描述
errcodeuint32错误报错码
errmsgstring错误报错信息
qrcode_contentstring设备动态身份识别二维码url。请将url生成二维码, 扫码使用
expires_inuint32二维码有效时间,这里固定5min 300s ,5min后动态二维码过期
注意
动态二维码调用频率限制为针对设备sn级别 1次/min,与获取设备管理二维码 获取动态设备管理二维码 共享同一调用频率限制
上一篇
获取设备管理二维码
下一篇
回调协议相关