消息服务

更新时间：2018-08-23 11:41:33

提供一组消息记录的操作服务接口，客户端应用通过本组服务接口可以实现对推送到用户客户端的消息记录的查询、统计和删除等操作。

统计用户的消息记录数量

定义描述

path 版本 描述 是否需要用户身份的鉴权
/message/center/record/messagetype/count 1.0.1 统计当前用户的消息记录数量 是，客户端SDK需启用身份的鉴权

请求参数

字段名 子键 类型 是否必填 备注
requestDTO Map
startCreateTime Date N 查询开始时间
endCreateTime Date N 查询结束时间
messageType String N 不传则三种都查
type String Y MESSAGE: 透传
NOTICE:推送
maxId Long N 查询条件：id <maxId
minId Long N 查询条件: id >minId
isRead Integer N 0: 未读
1：已读

返回参数

字段名 类型 描述
data Map k: device：设备 announcement：通知 share：分享

v:数量

示例

请求示例

{
    "id": "1509086454180",
    "version": "1.0",
    "request": {
        "apiVer": "1.0.1",
        "iotToken": "token"
    },
    "params": {
        "requestDTO": {
            "type": "NOTICE"
        }
    }
}

正常返回示例

{
    "code": 200,
    "data": {
        "share": 6,
        "device": 0,
        "announcement": 0
    },
    "message": "success"
}

错误码

错误码 错误信息 来源 描述
200 success 系统 成功
400 request error. 系统 请求错误
401 request auth error. 系统 请求认证错误
403 request forbidden. 系统 请求被禁止
404 service not found. 系统 服务未找到
429 too many requests. 系统 太多请求
460 request parameter error. 系统 请求参数错误
500 service error. 系统 服务端错误
503 service not available. 系统 服务不可用

查询用户的消息记录

定义描述

path 版本 描述 是否需要用户身份的鉴权
/message/center/record/query 1.0.1 查询当前用户的消息记录
 是，客户端SDK需启用身份的鉴权

请求参数

字段名 子键 类型 是否必填 备注
requestDTO Map
startCreateTime Date N 查询开始时间
endCreateTime Date N 查询结束时间
messageType String Y device：设备
announcement：通知
share：分享
type String Y MESSAGE: 透传
NOTICE:推送
maxId Long N 查询条件：id <maxId
minId Long N 查询条件: id >minId
pageNo Integer Y
pageSize Integer Y 最大100
isRead Integer N 0:未读
1：已读
sortType Integer N null or 0: gmtCreate倒排
1: gmtCreate正排

返回参数

字段名 子键 二级子键 三级子键 三级子键 类型 描述
data Map
count Long 总数
data id List
gmtCreate Date 创建时间
gmtModified Date 修改时间
appKey Long
title String
body String
messageType String 消息类型
设备、共享、通知
isRead Integer 阅读状态
extData Map 附加信息
device Map 设备信息
iotId String 设备id
productKey String 产品key
productName String 产品名称
icon String 图标
nickName String 昵称

示例

请求示例

{
    "id": "1509086454180",
    "version": "1.0",
    "request": {
        "apiVer": "1.0.1",
        "iotToken": "token"
    },
    "params": {
        "requestDTO": {
            "type": "NOTICE",
            "pageNo": 1,
            "pageSize": 20
        }
    }
}

正常返回示例

{
    "code": 200,
    "data": {
        "count": 102,
        "data": [{
            "appKey": 1234567,
            "body": "温度高",
            "deviceType": "iOS",
            "extData": {
                "device": {
                    "categoryId": 100,
                    "iotId": "iotId1",
                    "productKey": "p1",
                    "productName": "1"
                }
            },
            "gmtCreate": 1525351832000,
            "gmtModified": 1525351851000,
            "id": 1000000000000200439,
            "isRead": 1,
            "messageId": "-1",
            "messageType": "device",
            "scopeId": "scopeId1",
            "target": "ACCOUNT",
            "targetValue": "userId",
            "tenantId": "tenantId",
            "title": "测试",
            "type": "NOTICE"
        }],
        "queryPageNo": 1,
        "queryPageSize": 10
    },
    "message": "success"
}

错误码

错误码 错误信息 来源 描述
200 success 系统 成功
400 request error. 系统 请求错误
401 request auth error. 系统 请求认证错误
403 request forbidden. 系统 请求被禁止
404 service not found. 系统 服务未找到
429 too many requests. 系统 太多请求
460 request parameter error. 系统 请求参数错误
500 service error. 系统 服务端错误
503 service not available. 系统 服务不可用

逻辑删除用户的消息记录

定义描述

path 版本 描述 是否需要用户身份的鉴权
/message/center/record/delete 1.0.1 逻辑删除当前用户的消息记录 是，客户端SDK需启用身份的鉴权

请求参数

字段名 子键 类型 是否必填 备注
requestDTO Map
type String Y MESSAGE: 透传 NOTICE:推送
messageType String N
id Long N 消息记录id
maxId Long N 查询条件：id <maxId
minId Long N 查询条件: id >minId

返回参数

字段名 类型 描述
data Integer 删除的记录数量

示例

请求示例

{
    "id": "1509086454180",
    "version": "1.0",
    "request": {
        "apiVer": "1.0.1",
        "iotToken": "token"
    },
    "params": {
        "requestDTO": {
            "type": "NOTICE"
        }
    }
}

正常返回示例

{
    "code": 200,
    "data": 10,
    "message": "success"
}

错误码

错误码 错误信息 来源 描述
200 success 系统 成功
400 request error. 系统 请求错误
401 request auth error. 系统 请求认证错误
403 request forbidden. 系统 请求被禁止
404 service not found. 系统 服务未找到
429 too many requests. 系统 太多请求
460 request parameter error. 系统 请求参数错误
500 service error. 系统 服务端错误
503 service not available. 系统 服务不可用

物理删除用户的消息记录

定义描述

path 版本 描述 是否需要用户的身份鉴权
/message/center/record/delete/physical 1.0.1 物理删除当前用户的消息记录 是，客户端SDK需启用身份的鉴权

请求参数

字段名 子键 类型 是否必填 备注
requestDTO Map
type String Y MESSAGE: 透传 NOTICE:推送
messageType String N
id Long N 消息记录id
maxId Long N 查询条件：id <maxId
minId Long N 查询条件: id >minId

返回参数

字段名 类型 描述
data Integer 删除的记录数量

示例

请求示例

{
    "id": "1509086454180",
    "version": "1.0",
    "request": {
        "apiVer": "1.0.1",
        "iotToken": "token"
    },
    "params": {
        "requestDTO": {
            "type": "NOTICE"
        }
    }
}

正常返回示例

{
    "code": 200,
    "data": 10,
    "message": "success"
}

错误码

错误码 错误信息 来源 描述
200 success 系统 成功
400 request error. 系统 请求错误
401 request auth error. 系统 请求认证错误
403 request forbidden. 系统 请求被禁止
404 service not found. 系统 服务未找到
429 too many requests. 系统 太多请求
460 request parameter error. 系统 请求参数错误
500 service error. 系统 服务端错误
503 service not available. 系统 服务不可用

更新用户的消息记录

定义描述

path 版本 描述 是否需要用户身份的鉴权
/message/center/record/modify 1.0.1 更新当前用户的消息记录
目前仅支持更新只读状态		 是，客户端SDK需启用身份的鉴权

请求参数

字段名 子键 类型 是否必填 备注
requestDTO Map
id Long N 消息记录id
type String Y MESSAGE: 透传 NOTICE:推送
messageType String N
maxId Long N 查询条件：id <maxId
minId Long N 查询条件: id >minId
i​sRead I​nteger N​ 需要​更新的阅读状态
0​：未读
1：已读

返回参数

字段名 类型 描述
data Integer 更新的记录数量

示例

请求示例

{
    "id": "1509086454180",
    "version": "1.0",
    "request": {
        "apiVer": "1.0.1",
        "iotToken": "token"
    },
    "params": {
        "requestDTO": {
            "type": "NOTICE"
        }
    }
}

正常返回示例

{
    "code": 200,
    "data": 5,
    "message": "success"
}

错误码

错误码 错误信息 来源 描述
200 success 系统 成功
400 request error. 系统 请求错误
401 request auth error. 系统 请求认证错误
403 request forbidden. 系统 请求被禁止
404 service not found. 系统 服务未找到
429 too many requests. 系统 太多请求
460 request parameter error. 系统 请求参数错误
500 service error. 系统 服务端错误
503 service not available. 系统 服务不可用

拉取设备对应的告警配置列表

定义描述

path 版本 描述 是否需要用户身份的鉴权
/message/center/device/notice/list 1.0.5 拉取指定设备对应的告警提醒配置列表（只有配置为进行app应用推送的告警信息才会被获取到) 是，客户端SDK需启用身份的鉴权

请求参数

参数 类型 必填 描述
iotId String 是 设备ID

返回参数

参数 类型 必有 描述
alarmNotices List 否 告警提醒配置列表

alarmNotices表结构:

参数 类型 是否必填 备注
eventId String 是 告警事件ID
eventName String 是 告警事件名称
noticeEnabled Boolean 是 消息推送提醒开关
true：开启
false: 关闭

示例

请求示例

{
    "id": "1509086454180",
    "version": "1.0",
    "request": {
        "apiVer": "1.0.5"
    },
    "params": {
        "iotId" : "ChFrkX2CEx6DO88EHXNH0010803d10"
    }
}

正常返回示例

{
    "code": 200,
    "message": "success",
    "data": [
       {
           "eventId" : "18012",
           "eventName": "开门提醒",
           "noticeEnabled" : true
       },
       {
           "eventId" : "18013",
           "eventName": "劫持报警",
           "noticeEnabled" : false
       }
    ]
}

错误码

错误码 错误信息 来源 描述
200 success 系统 成功
400 request error. 系统 请求错误
401 request auth error. 系统 请求认证错误
403 request forbidden. 系统 请求被禁止
404 service not found. 系统 服务未找到
429 too many requests. 系统 太多请求
460 request parameter error. 系统 请求参数错误
500 service error. 系统 服务端错误
503 service not available. 系统 服务不可用

拉取设备告警全局提醒配置

定义描述

path 版本 描述 是否需要用户身份的鉴权
/message/center/device/global/notice/get 1.0.5 拉取指定设备的全局提醒配置 是，客户端SDK需启用身份的鉴权

请求参数

参数 类型 必填 描述
iotId String 是 设备ID

返回参数

参数 类型 必有 描述
data Boolean 是 消息推送提醒开关

true：开启

false: 关闭

示例

请求示例

{
    "id": "1509086454180",
    "version": "1.0",
    "request": {
        "apiVer": "1.0.5"
    },
    "params": {
        "iotId" : "ChFrkX2CEx6DO88EHXNH0010803d10"
    }
}

正常返回示例

{
    "code": 200,
    "message": "success",
    "data": true
}

错误码

错误码 错误信息 来源 描述
200 success 系统 成功
400 request error. 系统 请求错误
401 request auth error. 系统 请求认证错误
403 request forbidden. 系统 请求被禁止
404 service not found. 系统 服务未找到
429 too many requests. 系统 太多请求
460 request parameter error. 系统 请求参数错误
500 service error. 系统 服务端错误
503 service not available. 系统 服务不可用

设置设备告警提醒配置

定义描述

path 版本 描述 是否需要用户身份的鉴权
/message/center/device/notice/set 1.0.5 配置指定设备的某个告警提醒的开关 是，客户端SDK需启用身份的鉴权

请求参数

参数 类型 必填 描述
iotId String 是 设备ID
eventId String 是 告警事件ID
noticeEnabled Boolean 是 消息推送提醒开关
true：开启

false: 关闭 |

返回参数

参数 类型 必有 描述

示例

请求示例

{
    "id": "1509086454180",
    "version": "1.0",
    "request": {
        "apiVer": "1.0.5"
    },
    "params": {
        "iotId" : "ChFrkX2CEx6DO88EHXNH0010803d10",
        "eventId" : "18012",
        "noticeEnabled" : false
    }
}

正常返回示例

{
    "code": 200,
    "message": "success",
    "data": null
}

错误码

错误码 错误信息 来源 描述
200 success 系统 成功
400 request error. 系统 请求错误
401 request auth error. 系统 请求认证错误
403 request forbidden. 系统 请求被禁止
404 service not found. 系统 服务未找到
429 too many requests. 系统 太多请求
460 request parameter error. 系统 请求参数错误
500 service error. 系统 服务端错误
503 service not available. 系统 服务不可用

设置设备告警全局提醒配置

定义描述

path 版本 描述 是否需要用户身份的鉴权
/message/center/device/global/notice/set 1.0.5 配置指定设备的全局告警提醒的开关 是，客户端SDK需启用身份的鉴权

请求参数

参数 类型 必填 描述
iotId String 是 设备ID
noticeEnabled Boolean 是 消息推送提醒开关
true：开启

false: 关闭 |

返回参数

参数 类型 必有 描述

示例

请求示例

{
    "id": "1509086454180",
    "version": "1.0",
    "request": {
        "apiVer": "1.0.5"
    },
    "params": {
        "iotId" : "ChFrkX2CEx6DO88EHXNH0010803d10",
        "noticeEnabled" : false
    }
}

正常返回示例

{
    "code": 200,
    "message": "success",
    "data": null
}

错误码

错误码 错误信息 来源 描述
200 success 系统 成功
400 request error. 系统 请求错误
401 request auth error. 系统 请求认证错误
403 request forbidden. 系统 请求被禁止
404 service not found. 系统 服务未找到
429 too many requests. 系统 太多请求
460 request parameter error. 系统 请求参数错误
500 service error. 系统 服务端错误
503 service not available. 系统 服务不可用

results matching ""

    No results matching ""