# 消息通知

# 设备更新通知

当用户的设备列表、设备状态有更新时,可以调用本接口来通知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
isAsynctrue时,全部返回为0
Integer
foundResult.message 更新结果信息 String

注意:未查询到的userAccessToken,不会有状态返回;