说明

该接口由永顺智平台请求第三方开发者在开发平台设置的通知地址，会同步推送设备更新、状态变化等消息，所以第三方开发者应当做好响应的接口及处理

请求地址

由第三方开发者在云平台配置

统一请求参数

字段名称	字段说明	类型	长度	备注
header	系统级参数	Object	-	格式如下
header.type	请求类型	String	16	参考值： 1.CHECK_NOTIFY 上线审核校验通知 1.DEVICE_UPDATE_NOTIFY 设备更新通知 2.STATUS_UPDATE_NOTIFY 状态更新通知
header.version	版本	String	Y	默认1.0
header.requestTime	请求时间戳	String	Y	精确到毫秒
header.requestId	请求id	String	Y	-
payload	应用级参数	Object	-	根据业务类型可选，具体请参考接口详情

示例

{
  "header": {
    "type": "DEVICE_UPDATE_NOTIFY", 
    "version": 1, 
    "requestTime": 1506588295432, 
    "requestId": "304a1c510f9e4683a43be5f2a7cfeb52"
  }, 
  "payload": { }
}

请求响应

在接收到请求且正确处理后，需要第三方开发者一致响应字符串 “OK” 给永顺智开放平台
目前暂未开通重试功能，未来可能根据响应结果做请求重试。

上线审核校验通知

第三方开发者在申请应用上线时，我们会对其填写的“通知地址”发送以下报文进行校验，如果第三方开发者无正确应答“OK”，将无法通过应用审核

示例

{
  "header": {
    "type": "CHECK_NOTIFY", 
    "version": 1, 
    "requestTime": 1506588295432, 
    "requestId": "304a1c510f9e4683a43be5f2a7cfeb52"
  }, 
  "payload": { }
}

第三方平台response：”OK“

设备更新通知

当永顺智平台的设备发生新增，删除时，会通知持有设备的第三方开发者 第三方开发者收到通知后，需要主动调用设列表接口，刷新数据。

示例

{
  "header": {
    "type": "DEVICE_UPDATE_NOTIFY", 
    "version": 1, 
    "requestTime": 1506588295432, 
    "requestId": "304a1c510f9e4683a43be5f2a7cfeb52"
  }, 
  "payload": {
  }
}

状态更新通知

当设备发生状态变化时，会通知持有设备的第三方开发者

具体上报参数如下：

字段名称	字段说明	类型	长度	备注
deviceId	设备id	String	64	-
status	设备当前状态	Object	-	格式以状态名称为key，状态值为value组成的object对象，可参考示例

示例

{
  "header": {
      "type": "STATUS_UPDATE_NOTIFY", 
      "version": 1, 
      "requestTime": 1506588295432, 
      "requestId": "304a1c510f9e4683a43be5f2a7cfeb52"
   }, 
  "payload": {
    "deviceId": "xxx_xxx_xxxxxxxxxxx",
     "status": {
       "openFlag": 1,
       "tempSet": 26
     }
  }
}