Skip to content

锁-消息通知

开门通知列表

  1. 请求链接: /lockNoticeSettingAccount/list

  2. 请求方式: POST

  3. 参数说明:

名称类型是否必需示例描述
lockIdintY500锁ID
noticeTypeintY1010开门通知 20胁迫开门
  1. 返回参数及示例:
参数类型描述
statusInt状态码
statusTextString提示信息
contentString返回数据
listArray通知列表
idInt数据ID
lockIdInt锁ID
noticeTypeInt通知类型
settingValueObject设置值
openDoorIdInt开门ID
openDoorTypeInt开门方式
remarkString备注
noticeWayArray通知方式
typeString通知类型(mail/sms)
accountsArray账号列表
countryCodeInt国家代码
accountString账号
totalInt总数
pageNoInt页码
pageSizeInt每页数量
json
{
  "list": [
    {
      "id": 2,
      "lockId": 1782,
      "noticeType": 10,
      "settingValue": {
        "openDoorId": 1,
        "openDoorType": 1,
        "remark": "开门通知2",
        "noticeWay": [
          {
            "type": "mail",
            "accounts": [
              "123@qq.com",
              "1234@qq.com"
            ]
          },
          {
            "type": "sms",
            "accounts": [
              {
                "countryCode": 86,
                "account": "18111111111"
              },
              {
                "countryCode": 86,
                "account": "18111111112"
              }
            ]
          }
        ]
      },
      "created_at": "2024-04-20T05:48:42.000000Z",
      "updated_at": "2024-04-20T05:48:42.000000Z"
    },
    {
      "id": 3,
      "lockId": 1782,
      "noticeType": 10,
      "settingValue": {
        "openDoorId": 1,
        "openDoorType": 1,
        "remark": "开门通知2",
        "noticeWay": [
          {
            "type": "mail",
            "accounts": [
              "123@qq.com",
              "1234@qq.com"
            ]
          },
          {
            "type": "sms",
            "accounts": [
              {
                "countryCode": 86,
                "account": "18111111111"
              },
              {
                "countryCode": 86,
                "account": "18111111112"
              }
            ]
          }
        ]
      },
      "created_at": "2024-04-20T06:20:54.000000Z",
      "updated_at": "2024-04-20T06:20:54.000000Z"
    }
  ],
  "total": 2,
  "pageNo": 1,
  "pageSize": 10
}

添加开门通知

  1. 请求链接: /lockNoticeSettingAccount/add

  2. 请求方式: POST

  3. 参数说明:

名称类型是否必需示例描述
lockIdintY500锁ID
noticeTypeintY1010开门通知 20胁迫开门
settingValueobjectY{}格式看下方代码块

settingValue 格式说明:

  • openDoorId: 电子钥匙:id、密码:id、IC卡:id、指纹:id、人脸:id
  • openDoorType: 开门方式:请看常量列表 0.4.6. 钥匙类型
  • remark: 钥匙名称或备注
  • noticeWay: 通知方式数组
json
{
  "openDoorId": 100,
  "openDoorType": 1,
  "remark": "家人-电子钥匙",
  "noticeWay": [
    {
      "type": "mail",
      "accounts": [
        {
          "countryCode": 0,
          "account": "123@qq.com"
        },
        {
          "countryCode": 0,
          "account": "123456@qq.com"
        }
      ]
    },
    {
      "type": "sms",
      "accounts": [
        {
          "countryCode": 86,
          "account": "18111111111"
        },
        {
          "countryCode": 86,
          "account": "18111111112"
        }
      ]
    }
  ]
}
  1. 返回参数及示例:
参数类型描述
statusInt状态码
statusTextString提示信息
contentString返回数据
errorCodeInt错误码
descriptionString描述
errorMsgString错误信息
json
{
  "errorCode": 0,
  "description": "表示成功或是。",
  "errorMsg": "success or means yes"
}

更新开门通知

  1. 请求链接: /lockNoticeSettingAccount/update

  2. 请求方式: POST

  3. 参数说明:

名称类型是否必需示例描述
lockNoticeSettingAccountIdintY1数据ID
settingValueobjectY{}格式看下方代码块

settingValue 格式说明:

  • openDoorId: 电子钥匙:keyId、密码:keyboardpwdId、IC卡:cardId、指纹:fingerprintId、人脸:faceId
  • openDoorType: 开门方式:请看常量列表 0.4.6. 钥匙类型
  • remark: 钥匙名称或备注
  • noticeWay: 通知方式数组
json
{
  "openDoorId": 100,
  "openDoorType": 1,
  "remark": "家人-电子钥匙",
  "noticeWay": [
    {
      "type": "mail",
      "accounts": [
        {
          "countryCode": 0,
          "account": "123@qq.com"
        },
        {
          "countryCode": 0,
          "account": "123456@qq.com"
        }
      ]
    },
    {
      "type": "sms",
      "accounts": [
        {
          "countryCode": 86,
          "account": "18111111111"
        },
        {
          "countryCode": 86,
          "account": "18111111112"
        }
      ]
    }
  ]
}
  1. 返回参数及示例:
参数类型描述
statusInt状态码
statusTextString提示信息
contentString返回数据
errorCodeInt错误码
descriptionString描述
errorMsgString错误信息
json
{
  "errorCode": 0,
  "description": "表示成功或是。",
  "errorMsg": "success or means yes"
}

删除开门通知

  1. 请求链接: /lockNoticeSettingAccount/delete

  2. 请求方式: POST

  3. 参数说明:

名称类型是否必需示例描述
lockNoticeSettingAccountIdintY1数据ID
  1. 返回参数及示例:
参数类型描述
statusInt状态码
statusTextString提示信息
contentString返回数据
errorCodeInt错误码
descriptionString描述
errorMsgString错误信息
json
{
  "errorCode": 0,
  "description": "表示成功或是。",
  "errorMsg": "success or means yes"
}

设置N天未开门

  1. 请求链接: /lockSetting/updateLockNoticeSetting

  2. 请求方式: POST

  3. 参数说明:

名称类型是否必需示例描述
lockIdintY500锁ID
dayNotOpenDoorStateintY0N天未开门提醒开关:0/1
dayNotOpenDoorValueintN1门未开时间:单位天数
dayNotOpenDoorNoticeWayListarrayN[]通知方式:对象格式看下方

dayNotOpenDoorNoticeWayList 格式示例:

json
[
  {
    "type": "mail",
    "accounts": [
      {
        "countryCode": 0,
        "account": "123456@qq.com"
      },
      {
        "countryCode": 0,
        "account": "1234@qq.com"
      }
    ]
  },
  {
    "type": "sms",
    "accounts": [
      {
        "countryCode": 86,
        "account": "18111111111"
      },
      {
        "countryCode": 86,
        "account": "18111111112"
      }
    ]
  }
]
  1. 返回参数及示例:
参数类型描述
statusInt状态码
statusTextString提示信息
contentString返回数据
errorCodeInt错误码
descriptionString描述
errorMsgString错误信息
json
{
  "errorCode": 0,
  "description": "表示成功或是。",
  "errorMsg": "success or means yes"
}

设置门未关好

  1. 请求链接: /lockSetting/updateLockNoticeSetting

  2. 请求方式: POST

  3. 参数说明:

名称类型是否必需示例描述
lockIdintY500锁ID
doorNotCloseStateintY0门未关好开关:0/1
  1. 返回参数及示例:
参数类型描述
statusInt状态码
statusTextString提示信息
contentString返回数据
errorCodeInt错误码
descriptionString描述
errorMsgString错误信息
json
{
  "errorCode": 0,
  "description": "表示成功或是。",
  "errorMsg": "success or means yes"
}

设置防拆报警通知

  1. 请求链接: /lockSetting/updateLockNoticeSetting

  2. 请求方式: POST

  3. 参数说明:

名称类型是否必需示例描述
lockIdintY500锁ID
tamperAlarmStateintY0开关:0/1
  1. 返回参数及示例:
参数类型描述
statusInt状态码
statusTextString提示信息
contentString返回数据
errorCodeInt错误码
descriptionString描述
errorMsgString错误信息
json
{
  "errorCode": 0,
  "description": "表示成功或是。",
  "errorMsg": "success or means yes"
}

设置低电量提醒

  1. 请求链接: /lockSetting/updateLockNoticeSetting

  2. 请求方式: POST

  3. 参数说明:

名称类型是否必需示例描述
lockIdintY500锁ID
lowElecNoticeStateintY1通知开关:0/1
lowElecNoticeWayListarrayN[]通知方式:对象格式看下方

lowElecNoticeWayList 格式示例:

json
[
  {
    "type": "mail",
    "accounts": [
      {
        "countryCode": 0,
        "account": "13@qq.com"
      }
    ]
  },
  {
    "type": "sms",
    "accounts": [
      {
        "countryCode": 86,
        "account": "12345678911"
      }
    ]
  }
]
  1. 返回参数及示例:
参数类型描述
statusInt状态码
statusTextString提示信息
contentString返回数据
errorCodeInt错误码
descriptionString描述
errorMsgString错误信息
json
{
  "errorCode": 0,
  "description": "表示成功或是。",
  "errorMsg": "success or means yes"
}

胁迫开门通知列表

  1. 请求链接: /lockNoticeSettingAccount/list

  2. 请求方式: POST

  3. 参数说明:

名称类型是否必需示例描述
lockIdintY500锁ID
noticeTypeintY2020胁迫开门
  1. 返回参数及示例:
参数类型描述
statusInt状态码
statusTextString提示信息
contentString返回数据
listArray通知列表
idInt数据ID
lockIdInt锁ID
noticeTypeInt通知类型
settingValueObject设置值
openDoorIdInt开门ID
openDoorTypeInt开门方式
remarkString备注
noticeWayArray通知方式
typeString通知类型(mail/sms)
accountsArray账号列表
countryCodeInt国家代码
accountString账号
totalInt总数
pageNoInt页码
pageSizeInt每页数量
json
{
  "list": [
    {
      "id": 2,
      "lockId": 1782,
      "noticeType": 10,
      "settingValue": {
        "openDoorId": 1,
        "openDoorType": 1,
        "remark": "开门通知2",
        "noticeWay": [
          {
            "type": "mail",
            "accounts": [
              "123@qq.com",
              "1234@qq.com"
            ]
          },
          {
            "type": "sms",
            "accounts": [
              {
                "countryCode": 86,
                "account": "18111111111"
              },
              {
                "countryCode": 86,
                "account": "18111111112"
              }
            ]
          }
        ]
      },
      "created_at": "2024-04-20T05:48:42.000000Z",
      "updated_at": "2024-04-20T05:48:42.000000Z"
    },
    {
      "id": 3,
      "lockId": 1782,
      "noticeType": 10,
      "settingValue": {
        "openDoorId": 1,
        "openDoorType": 1,
        "remark": "开门通知2",
        "noticeWay": [
          {
            "type": "mail",
            "accounts": [
              "123@qq.com",
              "1234@qq.com"
            ]
          },
          {
            "type": "sms",
            "accounts": [
              {
                "countryCode": 86,
                "account": "18111111111"
              },
              {
                "countryCode": 86,
                "account": "18111111112"
              }
            ]
          }
        ]
      },
      "created_at": "2024-04-20T06:20:54.000000Z",
      "updated_at": "2024-04-20T06:20:54.000000Z"
    }
  ],
  "total": 2,
  "pageNo": 1,
  "pageSize": 10
}

添加胁迫开门通知

  1. 请求链接: /lockNoticeSettingAccount/add

  2. 请求方式: POST

  3. 参数说明:

名称类型是否必需示例描述
lockIdintY500锁ID
noticeTypeintY2020胁迫开门
settingValueobjectY{}格式看下方代码块

settingValue 格式说明:

  • openDoorId: 指纹:id、人脸:id
  • openDoorType: 开门方式:请看常量列表 0.4.6. 钥匙类型
  • remark: 指纹名称或备注
  • noticeWay: 通知方式数组
json
{
  "openDoorId": 100,
  "openDoorType": 1,
  "remark": "家人-指纹钥匙",
  "noticeWay": [
    {
      "type": "mail",
      "accounts": [
        {
          "countryCode": 0,
          "account": "123@qq.com"
        },
        {
          "countryCode": 0,
          "account": "123456@qq.com"
        }
      ]
    },
    {
      "type": "sms",
      "accounts": [
        {
          "countryCode": 86,
          "account": "18111111111"
        },
        {
          "countryCode": 86,
          "account": "18111111112"
        }
      ]
    }
  ]
}
  1. 返回参数及示例:
参数类型描述
statusInt状态码
statusTextString提示信息
contentString返回数据
errorCodeInt错误码
descriptionString描述
errorMsgString错误信息
json
{
  "errorCode": 0,
  "description": "表示成功或是。",
  "errorMsg": "success or means yes"
}

更新胁迫开门通知

  1. 请求链接: /lockNoticeSettingAccount/update

  2. 请求方式: POST

  3. 参数说明:

名称类型是否必需示例描述
lockNoticeSettingAccountIdintY1数据ID
settingValueobjectY{}格式看下方代码块

settingValue 格式说明:

  • openDoorId: 指纹:fingerprintId、人脸:faceId
  • openDoorType: 开门方式:请看常量列表 0.4.6. 钥匙类型
  • remark: 指纹名称或备注
  • noticeWay: 通知方式数组
json
{
  "openDoorId": 100,
  "openDoorType": 1,
  "remark": "家人-指纹钥匙",
  "noticeWay": [
    {
      "type": "mail",
      "accounts": [
        {
          "countryCode": 0,
          "account": "123@qq.com"
        },
        {
          "countryCode": 0,
          "account": "123456@qq.com"
        }
      ]
    },
    {
      "type": "sms",
      "accounts": [
        {
          "countryCode": 86,
          "account": "18111111111"
        },
        {
          "countryCode": 86,
          "account": "18111111112"
        }
      ]
    }
  ]
}
  1. 返回参数及示例:
参数类型描述
statusInt状态码
statusTextString提示信息
contentString返回数据
errorCodeInt错误码
descriptionString描述
errorMsgString错误信息
json
{
  "errorCode": 0,
  "description": "表示成功或是。",
  "errorMsg": "success or means yes"
}

删除胁迫开门通知

  1. 请求链接: /lockNoticeSettingAccount/delete

  2. 请求方式: POST

  3. 参数说明:

名称类型是否必需示例描述
lockNoticeSettingAccountIdintY1数据ID
  1. 返回参数及示例:
参数类型描述
statusInt状态码
statusTextString提示信息
contentString返回数据
errorCodeInt错误码
descriptionString描述
errorMsgString错误信息
json
{
  "errorCode": 0,
  "description": "表示成功或是。",
  "errorMsg": "success or means yes"
}

设置有人按门铃状态

  1. 请求链接: /lockSetting/updateLockNoticeSetting

  2. 请求方式: POST

  3. 参数说明:

名称类型是否必需示例描述
lockIdintY500锁ID
doorbellNoticeStateintY0开关:0/1
  1. 返回参数及示例:
参数类型描述
statusInt状态码
statusTextString提示信息
contentString返回数据
errorCodeInt错误码
descriptionString描述
errorMsgString错误信息
json
{
  "errorCode": 0,
  "description": "表示成功或是。",
  "errorMsg": "success or means yes"
}

设置有人出现在门口

  1. 请求链接: /lockSetting/updateLockNoticeSetting

  2. 请求方式: POST

  3. 参数说明:

名称类型是否必需示例描述
lockIdintY500锁ID
someoneAtDoorNoticeStateintY0开关:0/1
  1. 返回参数及示例:
参数类型描述
statusInt状态码
statusTextString提示信息
contentString返回数据
errorCodeInt错误码
descriptionString描述
errorMsgString错误信息
json
{
  "errorCode": 0,
  "description": "表示成功或是。",
  "errorMsg": "success or means yes"
}

获取锁消息设置

  1. 请求链接: /lockSetting/getLockNoticeSetting

  2. 请求方式: POST

  3. 参数说明:

名称类型是否必需示例描述
lockIdintY500锁ID
  1. 返回参数及示例:
参数类型描述
statusInt状态码
statusTextString提示信息
contentString返回数据
dayNotOpenDoorStateIntN天未开门状态
dayNotOpenDoorValueIntN天未开门天数
dayNotOpenDoorNoticeWayListArrayN天未开门通知方式
doorNotCloseStateInt门未关闭通知状态
tamperAlarmStateInt防拆报警状态
lowElecNoticeStateInt低电量通知状态
lowElecNoticeWayListArray低电量通知方式
coercionOpenDoorNoticeListArray胁迫开门通知列表
fingerprintIdInt指纹ID
doorbellNoticeStateInt有人按门铃通知状态
someoneAtDoorNoticeStateInt有人出现在门口通知状态
json
{
  "dayNotOpenDoorState": 0,
  "dayNotOpenDoorValue": 1,
  "dayNotOpenDoorNoticeWayList": [],
  "doorNotCloseState": 0,
  "tamperAlarmState": 0,
  "lowElecNoticeState": 1,
  "lowElecNoticeWayList": [
    {
      "type": "mail",
      "accounts": [
        "123@qq.com",
        "1234@qq.com"
      ]
    },
    {
      "type": "sms",
      "accounts": [
        {
          "countryCode": 86,
          "account": "18111111111"
        },
        {
          "countryCode": 86,
          "account": "18111111112"
        }
      ]
    }
  ],
  "coercionOpenDoorNoticeList": [
    {
      "fingerprintId": 10921,
      "noticeWay": [
        {
          "type": "mail",
          "accounts": [
            "123@qq.com",
            "1234@qq.com"
          ]
        },
        {
          "type": "sms",
          "accounts": [
            {
              "countryCode": 86,
              "account": "18111111111"
            },
            {
              "countryCode": 86,
              "account": "18111111112"
            }
          ]
        }
      ]
    }
  ],
  "doorbellNoticeState": 0,
  "someoneAtDoorNoticeState": 0
}

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