Skip to content

消息模块

获取消息列表

  1. 请求链接: /notifications/list

  2. 请求方式: POST

  3. 参数说明:

名称类型是否必需示例描述
pageNointY"1"分页
pageSizeintN20每页返回数
  1. 返回参数及示例:
参数类型描述
listobject消息列表
pageNoint分页pageNo
pageSizeint分页pageSize
  1. list参数:
参数类型描述
idint消息ID
dataString消息内容
createdAtString消息创建时间
readAtString消息已读时间 0代表未读
json
{
  "list": [
    {
      "id": "e07da0ed-49ba-45ea-943c-539a388849ec",
      "data": "您的锁:CDBN01_df4a6423,已被删除。",
      "createdAt": 1698989446000,
      "readAt": 1699062944000
    },
    {
      "id": "927f6175-9ba9-4fc5-9c3f-78655ac40c90",
      "data": "您的(CDBN01_df4a6423),于2023-11-03 09:44:44被开锁。",
      "createdAt": 1698975888000,
      "readAt": 0
    }
  ],
  "pageNo": 1,
  "pageSize": 10
}

标注消息已读

  1. 请求链接: /notifications/markAsRead

  2. 请求方式: POST

  3. 参数说明:

名称类型是否必需示例描述
idStringY"389ec86c-fd2c-47c5-887b-b37228ce70b7"消息ID
  1. 返回参数及示例:
参数类型描述
statusInt状态码
statusTextString提示信息
contentString返回数据
json
{
  "errorCode": 0,
  "description": "success",
  "errorMsg": "success",
  "data": null
}

删除单条消息

  1. 请求链接: /notifications/delete

  2. 请求方式: POST

  3. 参数说明:

名称类型是否必需示例描述
idStringY"389ec86c-fd2c-47c5-887b-b37228ce70b7"消息ID
  1. 返回参数及示例:
参数类型描述
statusInt状态码
statusTextString提示信息
contentString返回数据
json
{
  "errorCode": 0,
  "description": "success",
  "errorMsg": "success",
  "data": null
}

全部标注已读

  1. 请求链接: /notifications/markAllAsRead

  2. 请求方式: POST

  3. 参数说明:

名称类型是否必需示例描述
  1. 返回参数及示例:
参数类型描述
statusInt状态码
statusTextString提示信息
contentString返回数据
json
{
  "errorCode": 0,
  "description": "success",
  "errorMsg": "success",
  "data": null
}

删除全部消息

  1. 请求链接: /notifications/deleteAll

  2. 请求方式: POST

  3. 参数说明:

名称类型是否必需示例描述
  1. 返回参数及示例:
参数类型描述
statusInt状态码
statusTextString提示信息
contentString返回数据
json
{
  "errorCode": 0,
  "description": "success",
  "errorMsg": "success",
  "data": null
}

鑫泓佳智能硬件通信协议文档