用户扫码指令 - 接口文档 - 企业微信开发者中心

开发者中心

首页

教程

接口

社区

工具

智慧硬件开发

快速入门硬件直连接入硬件云端接入更新日志联系我们

智慧硬件开发硬件云端接入设备接入回调通知用户扫码指令

用户扫码指令

最后更新：2023/01/03

企业成员使用企业微信app扫描设备管理二维码或者设备身份二维码时，此时企业微信云端向设备推送该事件

请求方式：POST（HTTPS）
请求地址：https://127.0.0.1/suite/receive?msg_signature=3a7b08bb8e6dbce3c9671d6fdb69d15066227608&timestamp=1403610513&nonce=380320359

指令包体：

{
    "msg_type":"command",
    "base_info":{
        "req_id":"xxx",
        "device_sn":"xxx",
        "createtime":1658332800,
        "model_id":"xxx",
        "auth_corpid":"xxx",
        "service_corpid":"xxx"
    },
    "command":{
        "command_type":"user_scan",
        "oper_id":"xxxxx",
        "open_userid":"xx",
        "state":"STATE",
        "user_type":1,
        "auth_code":"xxxxx",
        "expires_in":300,
        "auth_code_type":1
    }
}}

参数名	类型	描述
msg_type	string	用于表示本消息是事件event 还是指令 command，此处固定为command , 对应command节点数据有效
command	结构体	指令数据
command_type	string	指令类型，成员录入识别信息，此处固定为user_scan
oper_id	string	本次操作的id
open_userid	string	成员id（字符串）
state	String	二维码上的自定义参数，参见“生成打印机二维码”或者“设备登录二维码”
user_type	uint32	扫码成员的类型。0：普通成员， 1：管理员
auth_code	string	授权码，用于其他特定接口调用
expires_in	uint32	授权码有效时间，单位秒
auth_code_type	uint32	授权码类型，1 扫描文件
base_info	结构体	固定字段基础数据
req_id	string	请求req_id，可以用于排重
device_sn	string	设备序列号，在第三方管理端登记的SN
createtime	uint32	事件触发时间戳（unix 时间戳单位：秒）
model_id	string	设备型号modelid
auth_corpid	string	绑定设备企业的corpid
service_corpid	string	硬件提供商企业corpid

服务商的响应必须在1000ms内完成

用户扫码被动回包
厂商云收到此事件回调后，需要被动回报当前设备，回包加密 encrypt 字段内容回包格式如下

{
    "online_status":1
}

参数说明：

参数名	类型	描述
online_status	uint32	设备在线状态：1-在线，2-离线

被动加密回包参考回调被动回包格式

获取设备状态指令

成员绑定硬件设备

本节内容

用户扫码指令