当企业绑定一台设备时,企业微信回调事件到厂商在设备型号详情中登记的回调URL
从企业微信添加设备成功后,企业微信后台会回调绑定时间和授权码,告知设备当前已经完成企业绑定,厂商根据该授权码auth_code,可获取到该设备的授权密钥。
请求方式:POST(HTTPS)
请求地址:https://127.0.0.1/suite/receive?msg_signature=3a7b08bb8e6dbce3c9671d6fdb69d15066227608×tamp=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_type | string | 用于表示本消息是 事件event 还是指令 command,此处固定为event , 对应event数据有效 |
event | 结构体 | 事件数据 |
event_type | string | 事件类型,绑定设备到企业此处固定为 bind |
auth_code | string | 授权码auth_code内容 |
verif_code | string | 绑定时用户输入的验证码 |
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内完成,最长3000ms,超过这个时间按照绑定失败处理
回包为空或者success表示回调处理成功
回调处理失败被动回包
如果绑定过程中,厂商云处理回调失败,回包加密 encrypt 字段内容回包格式如下
{
"errcode":0,
"errmsg":"ok"
}
参数说明:
参数名 | 类型 | 描述 |
---|---|---|
errcode | uint32 | 错误码 |
errmsg | string | 错误提示信息 |
被动加密回包参考 回调被动回包格式
被动回包错误码定义
errcode | errmsg显示描述 |
---|---|
0 | 成功 |
1 | 设备离线,请检查设备网络连接后重试 |
2 | 设备已被绑定,请解绑后重试 |
3 | 设备存在本地数据,请重置设备后重试 |
4 | 设备验证码校验不通过 |
注意:
1.绑定时服务商云在处理过程中,如果遇到以上绑定场景绑定失败被动回包时,errcode请严格按照上述表格场景对应的errcode进行回包
2.当服务商被动回包其他的错误码时,一律展示为未知原因导致添加失败,请重试。如重试后仍无法添加,请联系设备提供厂商协助解决
3.errcode为0时云端会认为服务商云绑定检查通过,企业微信会将此设备与操作者对应企业进行绑定,会忽略errmsg的信息