开发者中心
首页
教程
文档
社区
工具
智慧硬件开发
快速入门 硬件接入 服务端API 客户端API 附录 更新日志 联系我们
智慧硬件开发 服务端API 设备管理 回调通知 设备通知事件
设备通知事件

目录

  • 设备添加事件
  • 设备删除事件
  • 设备备注名称修改事件
  • 设备异常报警
  • 设备日志上传完成事件
  • 设备自定义属性上报事件

    • 设备添加事件

    从企业微信添加设备成功后，企业微信后台会推送添加成功通知。

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

    请求包体：
    xml请求示例：

    <xml>
	<DeviceSn><![CDATA[xxxx]]></DeviceSn>
	<AuthCorpId><![CDATA[xxxx]]></AuthCorpId>
	<InfoType><![CDATA[add_device]]></InfoType>
	<TimeStamp>1403610513</TimeStamp>
	<ServiceCorpId><![CDATA[xxxx]]></ServiceCorpId>
	<RemarkName><![CDATA[测试名称]]></RemarkName>
	<ModelId><![CDATA[MODEL]]></ModelId>
</xml>

    json请求示例：

    {
	"DeviceSn": "xxxx",
	"AuthCorpId": "xxxx",
	"InfoType": "add_device",
	"TimeStamp": 1403610513,
	"ServiceCorpId": "xxxx",
	"RemarkName": "测试名称",
	"ModelId": "MODEL"
}
    服务商的响应必须在1000ms内完成

    参数说明：

    参数说明
    DeviceSn设备序列号，在第三方管理端登记的SN
    AuthCorpId添加设备的企业ID
    InfoTypeadd_device
    TimeStamp时间戳
    ServiceCorpId服务商企业Id
    RemarkName设备备注名称
    ModelId设备型号id

    设备删除事件

    从企业微信删除设备成功，企业微信后台会推送删除成功通知。

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

    请求包体：
    xml请求示例：

    <xml>
	<DeviceSn><![CDATA[xxxx]]></DeviceSn>
	<AuthCorpId><![CDATA[xxxx]]></AuthCorpId>
	<InfoType><![CDATA[del_device]]></InfoType>
	<TimeStamp>1403610513</TimeStamp>
	<ServiceCorpId><![CDATA[xxxx]]></ServiceCorpId>
</xml>

    json请求示例：

    {
	"DeviceSn": "xxxx",
	"AuthCorpId": "xxxx",
	"InfoType": "del_device",
	"TimeStamp": 1403610513,
	"ServiceCorpId": "xxxx"
}
    服务商的响应必须在1000ms内完成

    参数说明：

    参数说明
    DeviceSn设备序列号，在第三方管理端登记的SN
    AuthCorpId删除设备的企业ID
    InfoTypedel_device
    TimeStamp时间戳
    ServiceCorpId服务商企业Id

     

    设备备注名称修改事件

    从企业微信修改设备备注名称成功，企业微信后台会推送设备备注名称修改通知。

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

    请求包体：
    xml请求示例：

    <xml>
	<DeviceSn><![CDATA[xxxx]]></DeviceSn>
	<AuthCorpId><![CDATA[xxxx]]></AuthCorpId>
	<InfoType><![CDATA[remark_device_name]]></InfoType>
	<TimeStamp>1403610513</TimeStamp>
	<ServiceCorpId><![CDATA[xxxx]]></ServiceCorpId>
	<RemarkName><![CDATA[TIT-B4 401投影]]></RemarkName>
</xml>

    json请求示例：

    {
	"DeviceSn": "xxxx",
	"AuthCorpId": "xxxx",
	"InfoType": "remark_device_name",
	"TimeStamp": 1403610513,
	"ServiceCorpId": "xxxx",
	"RemarkName": "TIT-B4 401投影"
}
    服务商的响应必须在1000ms内完成

    参数说明：

    参数说明
    DeviceSn设备序列号，在第三方管理端登记的SN
    AuthCorpId修改设备备注名称的企业ID
    InfoTyperemark_device_name
    TimeStamp时间戳
    ServiceCorpId服务商企业Id
    RemarkName设备备注名称

     

    设备异常报警

    当相关设备上报出错信息时，企业微信后台会推送设备上报的错误信息

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

    请求包体：
    xml请求示例：

    <xml>
	<DeviceSn><![CDATA[xxxx]]></DeviceSn>
	<InfoType><![CDATA[error_report]]></InfoType>
	<TimeStamp>1403610513</TimeStamp>
	<ServiceCorpId><![CDATA[xxxx]]></ServiceCorpId>
	<ErrCode>0</ErrCode>
	<ErrMsg><![CDATA[ok]]></ErrMsg>
</xml>

    json请求示例：

    {
	"DeviceSn": "xxxx",
	"InfoType": "error_report",
	"TimeStamp": 1403610513,
	"ServiceCorpId": "xxxx",
	"ErrCode": 0,
	"ErrMsg": "ok"
}
    服务商的响应必须在1000ms内完成

    参数说明：

    参数说明
    DeviceSn设备序列号，在第三方管理端登记的SN
    InfoTypeerror_report
    TimeStamp时间戳
    ServiceCorpId服务商企业Id
    ErrCode设备上报的错误码
    ErrMsg设备上报的错误信息

    设备日志上传完成事件

    当设备完成日志上传时，企业微信后台会推送对应日志文件的MediaId

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

    请求包体：
    xml请求示例：

    <xml>
	<DeviceSn><![CDATA[testsn]]></DeviceSn>
	<InfoType><![CDATA[fetch_log_finish]]></InfoType>
	<TimeStamp>1548074765</TimeStamp>
	<ServiceCorpId><![CDATA[xxxx]]></ServiceCorpId>
	<MediaId><![CDATA[testmediaid]]></MediaId>
</xml>

    json请求示例：

    {
	"DeviceSn": "testsn",
	"InfoType": "fetch_log_finish",
	"TimeStamp": 1548074765,
	"ServiceCorpId": "xxxx",
	"MediaId": "testmediaid"
}

    参数说明：

    参数说明
    DeviceSn设备序列号，在第三方管理端登记的SN
    InfoTypefetch_log_finish
    TimeStamp时间戳
    ServiceCorpId服务商企业Id
    MediaId上传日志的MediaId，可通过获取临时素材来获取数据内容
    完整的设备报警和日志上传流程可参考 报警和日志上报流程说明

     

    设备自定义属性上报事件

    设备调用上报设备自定义属性后，云端回调该事件到服务商系统接收事件url上。具体配置方法可以参考回调配置

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

    请求包体：
    xml请求示例：

    <xml>
	<InfoType><![CDATA[device_feature_change]]></InfoType>
	<TimeStamp>1568032757</TimeStamp>
	<AuthCorpId><![CDATA[wxxxxx]]></AuthCorpId>
	<ServiceCorpId><![CDATA[wxxxxx]]></ServiceCorpId> 
	<DeviceSn><![CDATA[SN]]></DeviceSn>
</xml>

    json请求示例：

    {
	"InfoType": "device_feature_change",
	"TimeStamp": 1568032757,
	"AuthCorpId": "wxxxxx",
	"ServiceCorpId": "wxxxxx",
	"DeviceSn": "SN"
}

    参数说明：

    参数说明
    InfoType请求类型，固定为device_feature_change
    TimeStamp时间戳
    AuthCorpId企业corpid
    ServiceCorpId服务商corpid
    DeviceSn设备序列号
    上一篇
    概述
    下一篇
    企业授权应用