企业绑定设备事件

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

服务商的响应必须在1000ms内完成
回包为空或者success表示回调处理成功

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

被动回包错误码定义

errcode	errmsg显示描述
1	设备离线，请检查设备网络连接后重试
2	设备已被绑定，请解绑后重试
3	设备存在本地数据，请重置设备后重试
4	设备验证码校验不通过

注意：
1.绑定时服务商云在处理过程中，如果遇到以上绑定场景绑定失败被动回包时，errcode请严格按照上述表格场景对应的errcode进行回包
2.当服务商被动回包其他的错误码时，一律展示为未知原因导致添加失败，请重试。如重试后仍无法添加，请联系设备提供厂商协助解决

curl --location --request POST 'https://127.0.0.1/suite/receive' \ --header 'Content-Type: application/json' \ --data-raw '{ "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" } }'

请求参数

Query 参数

msg_signature

string

可选

示例值:

3a7b08bb8e6dbce3c9671d6fdb69d15066227608

timestamp

string

可选

示例值:

1403610513

nonce

string

可选

示例值:

380320359

Body 参数application/json

msg_type

string

必需

用于表示本消息是事件event 还是指令 command，此处固定为event , 对应event数据有效

base_info

object

固定字段基础数据

必需

req_id

string

必需

请求req_id，可以用于排重

device_sn

string

必需

设备序列号，在第三方管理端登记的SN

createtime

integer

必需

事件触发时间戳（unix 时间戳单位：秒）

model_id

string

必需

设备型号modelid

auth_corpid

string

必需

绑定设备企业的corpid

service_corpid

string

必需

硬件提供商企业corpid

event

object

事件数据

必需

event_type

string

必需

事件类型，绑定设备到企业此处固定为 bind

auth_code

string

必需

授权码auth_code内容

verif_code

string

必需

绑定时用户输入的验证码

示例

请求参数

返回响应