常规数据加载

查询房间数据

http 请求方式：POST（请使用 https 协议）https://api.kdware.cn/hapi/v1.1/loadRooms

功能简介：用于按条件查询房间数据

请求示例

参数说明

{
  "sessionid": "6614a268-a886-4767-a8ef-60ff64229ef3"
}
参数类型可选说明
sessionidstring必须会话凭证
offsetnumber可选指定返回记录行的偏移量
countnumber可选指定返回记录行的最大数目,最大值为 100
byIDstring可选按 ID 查询

返回结果

正确时的返回 JSON 数据包如下：

{
  "resultCode": 0,
  "deviceList": [
    {
      "roomID": "1",
      "sysID": "1",
      "roomName": "Test1",
      "roomState": 0,
      "voltage": "6.00",
      "firmVer": "88.99",
      "macID": "11:22:33:44:55:66",
      "rtuID": "123",
      "rtuState": 1
    },
    {
      "roomID": "1",
      "sysID": "1",
      "roomName": "Test2",
      "roomState": 0,
      "voltage": "6.00",
      "firmVer": "88.99",
      "macID": "11:22:33:44:55:77",
      "rtuID": "0",
      "rtuState": 0
    }
  ]
}
参数类型说明
resultCodenumber0 为成功，其它值为失败
deviceListarray
参数 类型 说明
roomID string 房间 ID 号
sysID string 系统 ID 号
roomName string 房间名称
roomState number 房间状态，0 为空房，1 为在住
voltage string 门锁电池当前电压, 低于 4.8 即可认为低电压
firmVer string 固件版本号
macID string 设备物理地址
rtuID string 已关联网关ID，为0表示未关联
rtuState number 已关联网关的在线状态，为1表示在线，为0表示离线

查询在住客人钥匙记录

http 请求方式：POST（请使用 https 协议）https://api.kdware.cn/hapi/v1.1/loadCurrentGuests

功能简介：用于按条件查询当前在住客人钥匙记录

请求示例

参数说明

{
  "sessionid": "6614a268-a886-4767-a8ef-60ff64229ef3"
}
参数类型可选说明
sessionidstring必须会话凭证
offsetnumber可选指定返回记录行的偏移量
countnumber可选指定返回记录行的最大数目,最大值为 100
byIDstring可选按 ID 查询
byGuestNamestring可选按客人名称查询，不支持模糊查找
byRoomIDstring可选按房间 ID 号查询

返回结果

正确时的返回 JSON 数据包如下：

{
  "resultCode": 0,
  "rtuList": [
    {
      "keyID": "1",
      "type": 1001,
      "state": 2,
      "maker": "138...",
      "owner": "Test",
      "beginDate": "2021-07-25T10:37",
      "endDate": "2021-07-26T12:00",
      "sysID": "1",
      "roomID": "1",
      "mobile": "138...",
      "pinCode": "123456"
    }
  ]
}
参数类型说明
resultCodenumber0 为成功，其它值为失败
keyListarray
参数 类型 说明
keyID string ID 号
type number 钥匙类型，1 为客人卡，99 为手机，100 为离线密码，1001 为手机密码组合
state number 钥匙状态，1 为预定状态，2 为有效，5 为已过期（需进行无卡注销）
maker string 授权账号名称
owner string 客人名称
beginDate string 钥匙生效时间
endDate string 钥匙失效时间
sysID string 系统 ID 号
roomID string 房间 ID 号
mobile string 客人关联手机号
pinCode string 客人开门密码

查询开门事件数据

http 请求方式：POST（请使用 https 协议）https://api.kdware.cn/hapi/v1.1/loadRoomEvents

功能简介：

请求示例

参数说明

{
  "sessionid": "6614a268-a886-4767-a8ef-60ff64229ef3"
}
参数类型可选说明
sessionidstring必须会话凭证
offsetnumber可选指定返回记录行的偏移量
countnumber可选指定返回记录行的最大数目,最大值为 100
byGuestNamestring可选按客人名称查询，不支持模糊查找
byRoomIDstring可选按房间 ID 号查询

返回结果

正确时的返回 JSON 数据包如下：

{
  "resultCode": 0,
  "eventList": [
    {
      "eventID": "8447635",
      "roomID": "65558",
      "owner": "Uuuu",
      "eventTime": "2021-07-24T10:26"
    },
    {
      "eventID": "8447636",
      "roomID": "65558",
      "owner": "Uuuu",
      "eventTime": "2021-07-24T10:26"
    },
    {
      "eventID": "8447637",
      "roomID": "65558",
      "owner": "Uuuu",
      "eventTime": "2021-07-24T10:26"
    }
  ]
}
参数类型说明
resultCodenumber0 为成功，其它值为失败
eventListarray
参数 类型 说明
eventID string ID 号
roomID string 所属房间 ID 号
owner string 操作人
eventTime string 发生时间，该值为 ISO 时间格式
Previous
无卡注销授权操作
Next
其于DLL的API定义