消息通知

• 设备更新通知
  • 接口地址
  • 消息样式
  • 响应数据

设备更新通知

当用户的设备列表、设备状态有更新时，可以调用本接口来通知iFLYOS对用户设备进行更新；

接口地址

https://iot.iflyos.cn/smart_home/notification/update_devices

消息样式

{
  "serviceId": "xxxx",
  "messageId": "xxxx",
  "isAsync": true,
  "userAccessTokens": [
    "xxxx"
  ]
}

参数说明：

参数	说明	类型
serviceId	智能家居服务的唯一标识	String
messageId	代表一条message的唯一ID，建议使用UUID	String
isAsync	是否需要异步更新，默认为true 当设置为false时，该接口会在全部更新完成后，再返回响应 当设置为true时，该接口立即返回，iFLYOS将进行异步更新	Boolean
userAccessTokens	用户授权给iFLYOS的令牌 同一用户的多个令牌（可能用户多次授权，遗留多个有效令牌），或者多个用户的多个令牌	String

响应数据

{
  "messageId": "xxxx",
  "foundResult": [
    {
      "userAccessToken": "xxxx",
      "status": 0,
      "message": "更新成功"
    }
  ]
}

参数说明：

参数	说明	类型
messageId	本条message的唯一ID	String
foundResult	iFLYOS服务中有效userAccessToken的更新结果列表	String
foundResult.userAccessToken	有效的userAccessToken	String
foundResult.status	更新结果，成功为0，失败为1 当isAsync为true时，全部返回为0	Integer
foundResult.message	更新结果信息	String

注意：未查询到的userAccessToken，不会有状态返回；