智慧硬件开发 硬件云端接入 设备接入 回调通知 查询设备SN合法性事件
查询设备SN合法性事件
最后更新:2022/12/05
可联系渠道经理采购或代理智慧硬件接口已支持设备 联系渠道经理
查询设备SN合法性事件
最后更新:2022/12/05

当用户进入绑定页面,输入的SN没在服务商后台进行登记时,企业微信尝试触发本回调给指定服务商,查询设备SN是否合法,及所属modelid。企业微信回调指令到厂商在智慧硬件-通用开发参数登记的回调URL。

注意:本回调与返回包信息需按照回调协议,服务商通用地址回调协议进行加解密。

 

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

{
    "msg_type":"event",
    "base_info":{
        "req_id":"xxx",
        "createtime":1658332800,
        "auth_corpid":"xxx",
        "service_corpid":"xxx"
    },
    "event":{
        "event_type":"verify_device",
        "device_sn_md5":"xxx"
    }
}

参数说明:

参数名类型描述
msg_typestring用于表示本消息是 事件event 还是指令 command,此处固定为command , 对应command节点数据有效
command结构体指令数据
command_typestring指令类型,固件升级,此处固定为verify_device
device_sn_md5string设备序列号的md5值
base_info结构体固定字段基础数据
req_idstring请求req_id,可以用于排重
createtimeuint32事件触发时间戳(unix 时间戳 单位:秒)
auth_corpidstring绑定设备企业的corpid
service_corpidstring硬件提供商企业corpid

返回结果:

{
    "is_valid":true,
    "modelid":"XXX"
}

参数说明:

参数名类型描述
is_validbool用于表示该SN是否是本企业合法的SN
modelidstring若SN合法,用于表示SN所属的型号id
服务商的响应必须在1000ms内完成
上一篇
设备型号model_ticket推送事件
下一篇
获取设备状态指令