智慧硬件开发 服务端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设备序列号
    上一篇
    概述
    下一篇
    企业授权应用