智慧硬件开发
智慧硬件开发
硬件云端接入
设备接入
回调通知
用户扫码指令
用户扫码指令
最后更新: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_typestring用于表示本消息是 事件event 还是指令 command,此处固定为command , 对应command节点数据有效
command结构体指令数据
command_typestring指令类型,成员录入识别信息,此处固定为user_scan
oper_idstring本次操作的id
open_useridstring成员id(字符串)
stateString二维码上的自定义参数,参见“生成打印机二维码”或者“设备登录二维码
user_typeuint32扫码成员的类型。0:普通成员, 1:管理员
auth_codestring授权码,用于其他特定接口调用
expires_inuint32授权码有效时间,单位秒
auth_code_typeuint32授权码类型,1 扫描文件
base_info结构体固定字段基础数据
req_idstring请求req_id,可以用于排重
device_snstring设备序列号,在第三方管理端登记的SN
createtimeuint32事件触发时间戳(unix 时间戳 单位:秒)
model_idstring设备型号modelid
auth_corpidstring绑定设备企业的corpid
service_corpidstring硬件提供商企业corpid
服务商的响应必须在1000ms内完成

 

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

{
    "online_status":1
}

参数说明:

参数名类型描述
online_statusuint32设备在线状态:1-在线,2-离线
被动加密回包参考 回调被动回包格式
上一篇获取设备状态指令
下一篇成员绑定硬件设备
    本节内容
硬件直连接入
更新日志
联系我们