# 消息通知
# 设备更新通知
当用户的设备列表、设备状态有更新时,可以调用本接口来通知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
,不会有状态返回;