智慧硬件开发
智慧硬件开发
硬件云端接入
设备接入
回调通知
企业绑定设备事件
企业绑定设备事件
最后更新:2023/04/17

当企业绑定一台设备时,企业微信回调事件到厂商在设备型号详情中登记的回调URL
从企业微信添加设备成功后,企业微信后台会回调绑定时间和授权码,告知设备当前已经完成企业绑定,厂商根据该授权码auth_code,可获取到该设备的授权密钥。

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

{
    "msg_type":"event",
    "base_info":{
        "req_id":"xxx",
        "device_sn":"xxx",
        "createtime":1658332800,
        "model_id":"xxx",
        "auth_corpid":"xxx",
        "service_corpid":"xxx"
    },
    "event":{
        "event_type":"bind",
        "auth_code":"xxx",
        "verif_code":"xxx"
    }
}

参数说明:

参数名类型描述
msg_typestring用于表示本消息是 事件event 还是指令 command,此处固定为event , 对应event数据有效
event结构体事件数据
event_typestring事件类型,绑定设备到企业此处固定为 bind
auth_codestring授权码auth_code内容
verif_codestring绑定时用户输入的验证码
base_info结构体固定字段基础数据
req_idstring请求req_id,可以用于排重
device_snstring设备序列号,在第三方管理端登记的SN
createtimeuint32事件触发时间戳(unix 时间戳 单位:秒)
model_idstring设备型号modelid
auth_corpidstring绑定设备企业的corpid
service_corpidstring硬件提供商企业corpid
服务商的响应尽可能在1000ms内完成,最长3000ms,超过这个时间按照绑定失败处理
回包为空或者success表示回调处理成功

 

回调处理失败被动回包
如果绑定过程中,厂商云处理回调失败,回包加密 encrypt 字段内容回包格式如下

{
    "errcode":0,
    "errmsg":"ok"
}

参数说明:

参数名类型描述
errcodeuint32错误码
errmsgstring错误提示信息
被动加密回包参考 回调被动回包格式

被动回包错误码定义

errcodeerrmsg显示描述
0成功
1设备离线,请检查设备网络连接后重试
2设备已被绑定,请解绑后重试
3设备存在本地数据,请重置设备后重试
4设备验证码校验不通过
注意:
1.绑定时服务商云在处理过程中,如果遇到以上绑定场景绑定失败被动回包时,errcode请严格按照上述表格场景对应的errcode进行回包
2.当服务商被动回包其他的错误码时,一律展示为未知原因导致添加失败,请重试。如重试后仍无法添加,请联系设备提供厂商协助解决
3.errcode为0时云端会认为服务商云绑定检查通过,企业微信会将此设备与操作者对应企业进行绑定,会忽略errmsg的信息
上一篇回调协议相关
下一篇企业解绑设备事件
    本节内容
硬件直连接入
更新日志
联系我们