钥匙用户模块
锁用户列表/搜索锁用户列表
请求链接:
/keyUser/listKeyUser请求方式:
POST参数说明:
| 名称 | 类型 | 是否必需 | 示例 | 描述 |
|---|---|---|---|---|
| pageNo | String | Y | "1" | 页码 |
| pageSize | String | Y | "20" | 每页数量 |
| searchStr | String | Y | "" | 搜索需传入此参数 |
- 返回参数及示例:
| 参数 | 类型 | 描述 |
|---|---|---|
| status | Int | 状态码 |
| statusText | String | 提示信息 |
| content | String | 返回数据 |
| list | Array | 用户列表 |
| uid | Int | 用户ID |
| nickname | String | 昵称 |
| headUrl | String | 头像URL |
| userid | String | 用户账号 |
{
"list": [
{
"uid": 16599773,
"nickname": "张图",
"headUrl": "",
"userid": "786612630@qq.com"
},
{
"uid": 17136099,
"nickname": "张图",
"headUrl": "",
"userid": "78661263@qq.com"
},
{
"uid": 17135615,
"nickname": "章丘",
"headUrl": "",
"userid": "15080825640@163.com"
},
{
"uid": 17136213,
"nickname": "赵姐",
"headUrl": "",
"userid": "8632147526@qq.com"
}
]
}群发钥匙检查
请求链接:
/keyUser/canSendKey请求方式:
POST参数说明:
| 名称 | 类型 | 是否必需 | 示例 | 描述 |
|---|---|---|---|---|
| endDate | String | Y | "1689665220000" | 结束时间 |
| lockIdList | String | Y | "[]" | 锁ID列表(JSON字符串) |
- 返回参数及示例:
| 参数 | 类型 | 描述 |
|---|---|---|
| status | Int | 状态码 |
| statusText | String | 提示信息 |
| content | String | 返回数据 |
| errorCode | Int | 错误码 |
| description | String | 描述 |
| errorMsg | String | 错误信息 |
说明:该接口检查钥匙是否可以发送钥匙,如果可以发送,则发送。如果钥匙的有效期小于当前选择的时间,则提示。主要是检查授权管理员的钥匙。
成功示例:
{
"errorCode": 0,
"description": "表示成功或是。",
"errorMsg": "success or means yes"
}失败示例:
{
"errorCode": -3039,
"description": "你自己钥匙的有效期小于当前选择的时间,请重新选择时间或者联系管理员调整你的钥匙有效期。\n钥匙名称:MCBN01_210576",
"errorMsg": "Authorized ekey time not enough."
}批处理群发钥匙
请求链接:
/key/batchSend请求方式:
POST参数说明:
| 名称 | 类型 | 是否必需 | 示例 | 描述 |
|---|---|---|---|---|
| lockIds | array | Y | [500, 501] | 锁列表 |
| createUser | int | Y | 0 | 发送的邮箱/手机号未注册时重新调用接口加这个字段传1 |
| countryCode | String | Y | "" | 国家区号(createUser=1时使用) |
| receiverUsername | String | Y | "123@qq.com" | 手机号/邮箱地址 |
| keyName | String | Y | "张三" | 钥匙接受者姓名 |
| keyType | int | Y | 1 | 钥匙类型 |
| weekDays | array | N | [1, 2, 3, 4, 7] | 循环钥匙必填 |
| startDate | int | Y | 0 | 永久可默认0 |
| endDate | int | Y | 0 | 永久可默认0 |
| startTime | int | N | 1710032400000 | keyType为循环可填,生效时间:09:00 转毫秒时间 |
| endTime | int | N | 1710079200000 | keyType为循环可填,失效时间:23:00 转毫秒时间 |
| remoteUnlockSwitch | int | Y | 0 | 是否支持远程开锁开关:1-是、2-否 |
| keyRight | int | Y | 0 | 是否授权管理员 |
- 返回参数及示例:
| 参数 | 类型 | 描述 |
|---|---|---|
| status | Int | 状态码 |
| statusText | String | 提示信息 |
| content | String | 返回数据 |
| keyId | Int | 钥匙ID |
| receiverUid | Int | 接收者用户ID |
{
"keyId": 109750817,
"receiverUid": 16599773
}用户拥有的锁
请求链接:
/keyUser/listByUse请求方式:
POST参数说明:
| 名称 | 类型 | 是否必需 | 示例 | 描述 |
|---|---|---|---|---|
| pageNo | String | Y | "1" | 页码 |
| pageSize | String | Y | "20" | 每页数量 |
| uid | String | Y | "16599773" | 用户ID |
- 返回参数及示例:
| 参数 | 类型 | 描述 |
|---|---|---|
| status | Int | 状态码 |
| statusText | String | 提示信息 |
| content | String | 返回数据 |
| list | Array | 锁列表 |
| lockId | Int | 锁ID |
| uid | Int | 用户ID |
| lockAlias | String | 锁别名 |
| keyStatus | String | 钥匙状态 |
| endDate | Long | 结束时间 |
| keyId | Int | 钥匙ID |
| startDate | Long | 开始时间 |
| keyRight | Int | 钥匙权限 |
{
"list": [
{
"lockId": 9418481,
"uid": 16599773,
"lockAlias": "MCBN01_8f3106",
"keyStatus": "110412",
"endDate": 1689405179000,
"keyId": 109084863,
"startDate": 1689318720000,
"keyRight": 0
}
]
}即将到期的电子钥匙列表
请求链接:
/keyUser/listExpireUser请求方式:
POST参数说明:
| 名称 | 类型 | 是否必需 | 示例 | 描述 |
|---|---|---|---|---|
| pageNo | String | Y | "1" | 页码 |
| pageSize | String | Y | "20" | 每页数量 |
说明:查出的是在一个月内到期的
- 返回参数及示例:
| 参数 | 类型 | 描述 |
|---|---|---|
| status | Int | 状态码 |
| statusText | String | 提示信息 |
| content | String | 返回数据 |
| list | Array | 钥匙列表 |
| lockAlias | String | 锁别名 |
| keyStatus | String | 钥匙状态 |
| endDate | Long | 结束时间 |
| startDay | Long | 开始日期 |
| headUrl | String | 头像URL |
| keyId | Int | 钥匙ID |
| userid | String | 用户账号 |
| colorType | Int | 颜色类型 |
| lockId | Int | 锁ID |
| uid | Int | 用户ID |
| weekDays | String | 有效星期(JSON字符串) |
| endDay | Long | 结束日期 |
| nickname | String | 昵称 |
| nickname2 | String | 昵称2 |
| keyType | Int | 钥匙类型 |
| startDate | Long | 开始时间 |
| keyRight | Int | 钥匙权限 |
| description | String | 描述 |
| pageNo | Int | 页码 |
| pageSize | Int | 每页数量 |
| pages | Int | 总页数 |
| total | Int | 总数 |
{
"list": [
{
"lockAlias": "MCBN01_8f3106",
"keyStatus": "110411",
"endDate": 1689242400000,
"startDay": 1689264000000,
"headUrl": "",
"keyId": 109086023,
"userid": "8632147526@qq.com",
"colorType": 1,
"lockId": 9418481,
"uid": 17136213,
"weekDays": "[1,7]",
"endDay": 1689436799000,
"nickname": "赵姐",
"nickname2": "8632147526",
"keyType": 4,
"startDate": 1689210000000,
"keyRight": 0
},
{
"lockAlias": "MCBN01_8f3106",
"keyStatus": "110401",
"endDate": 1689405179000,
"headUrl": "",
"keyId": 109084863,
"description": "即将过期",
"userid": "786612630@qq.com",
"colorType": 1,
"lockId": 9418481,
"uid": 16599773,
"nickname": "张图",
"nickname2": "午夜",
"startDate": 1689318720000,
"keyRight": 0
}
],
"pageNo": 1,
"pageSize": 20,
"pages": 1,
"total": 2
}修改有效期
请求链接:
/key/updateKeyDate请求方式:
POST
说明:跟"3.2.5编辑电子钥匙的有效期、有效时间、有效日的"接口一样
- 参数说明:
| 名称 | 类型 | 是否必需 | 示例 | 描述 |
|---|---|---|---|---|
| endDate | String | Y | "1689242400000" | 结束时间 |
| endDay | String | Y | "1689695999000" | 不使用 |
| keyId | String | Y | "109086023" | 钥匙ID |
| lockId | String | Y | "9418481" | 锁ID |
| startDate | String | Y | "1689210000000" | 开始时间 |
| startDay | String | Y | "1689264000000" | 不使用 |
| uid | String | Y | "17136213" | 用户ID |
| weekDays | String | Y | "[1,7]" | 有效星期(JSON字符串) |
- 返回参数及示例:
| 参数 | 类型 | 描述 |
|---|---|---|
| status | Int | 状态码 |
| statusText | String | 提示信息 |
| content | String | 返回数据 |
| errorCode | Int | 错误码 |
| description | String | 描述 |
| errorMsg | String | 错误信息 |
{
"errorCode": 0,
"description": "表示成功或是。",
"errorMsg": "success or means yes"
}分组列表(已废弃)
请求链接:
/keyGroup/list请求方式:
POST
说明:已废弃(包含了授权管理员的锁)
- 参数说明:
| 名称 | 类型 | 是否必需 | 示例 | 描述 |
|---|---|---|---|---|
| type | String | Y | "2" | 类型 |
- 返回参数及示例:
| 参数 | 类型 | 描述 |
|---|---|---|
| status | Int | 状态码 |
| statusText | String | 提示信息 |
| content | String | 返回数据 |
| list | Array | 分组列表 |
| lockNum | Int | 锁总数量 |
| keyGroupId | Int | 组ID |
| keyGroupName | String | 组名 |
| groupType | Int | 组类型 0未分组 1非未分组 |
| lockList | Array | 锁列表 |
| lockId | Int | 锁ID |
| lockAlias | String | 锁名 |
{
"list": [
{
"lockNum": 4,
"keyGroupId": 29,
"keyGroupName": "未分组",
"groupType": 0,
"lockList": [
{
"lockId": 500,
"lockAlias": "公司会议室通道锁"
},
{
"lockId": 501,
"lockAlias": "公司会议门禁锁"
},
{
"lockId": 1711,
"lockAlias": "CDBN01_df4a6425"
},
{
"lockId": 1713,
"lockAlias": "CDBN01_df4a646"
}
]
},
{
"lockNum": 2,
"keyGroupId": 326,
"keyGroupName": "哈哈哈1",
"groupType": 1,
"lockList": [
{
"lockId": 1683,
"lockAlias": "CDBN01_df4a6423"
},
{
"lockId": 1685,
"lockAlias": "TMH_30d80f8a8206"
}
]
},
{
"lockNum": 0,
"keyGroupId": 333,
"keyGroupName": "哈哈哈2",
"groupType": 1,
"lockList": []
}
]
}分组下的锁(已废弃)
请求链接:
/room/listByGroup请求方式:
POST
说明:已废弃
- 参数说明:
| 名称 | 类型 | 是否必需 | 示例 | 描述 |
|---|---|---|---|---|
| keyGroupId | String | Y | "0" | 分组ID |
| type | String | Y | "2" | 类型 |
- 返回参数及示例:
| 参数 | 类型 | 描述 |
|---|---|---|
| status | Int | 状态码 |
| statusText | String | 提示信息 |
| content | String | 返回数据 |
| list | Array | 锁列表 |
| lockId | String | 锁ID |
| lockAlias | String | 锁别名 |
{
"list": [
{
"lockId": "222",
"lockAlias": "MCBN01_210576"
},
{
"lockId": "222",
"lockAlias": "MCBN01_210576"
}
]
}删除用户
请求链接:
/keyUser/deleteKeyUser请求方式:
POST参数说明:
| 名称 | 类型 | 是否必需 | 示例 | 描述 |
|---|---|---|---|---|
| uid | String | Y | "2" | 用户ID |
- 返回参数及示例:
| 参数 | 类型 | 描述 |
|---|---|---|
| status | Int | 状态码 |
| statusText | String | 提示信息 |
| content | String | 返回数据 |
| errorCode | Int | 错误码 |
| description | String | 描述 |
| errorMsg | String | 错误信息 |
{
"errorCode": 0,
"description": "表示成功或是。",
"errorMsg": "success or means yes"
}即将到期的密码列表
请求链接:
/keyUser/listExpirePwd请求方式:
POST参数说明:
| 名称 | 类型 | 是否必需 | 示例 | 描述 |
|---|---|---|---|---|
| pageNo | int | N | 1 | 页码 |
| pageSize | int | N | 20 | 每页数量 |
- 返回参数及示例:
| 参数 | 类型 | 描述 |
|---|---|---|
| status | Int | 状态码 |
| statusText | String | 提示信息 |
| content | String | 返回数据 |
| list | Array | 密码列表 |
| clientId | String | 客户端ID |
| lockOwnerId | Int | 锁所有者ID |
| lockId | Int | 锁ID |
| keyboardPwdType | Int | 密码类型 |
| keyboardPwdStatus | Int | 密码状态 |
| startDate | Long | 开始时间 |
| endDate | Long | 结束时间 |
| keyboardPwd | String | 密码 |
| keyboardPwdHash | String | 密码哈希 |
| addType | Int | 添加类型 |
| pwdRight | Int | 密码权限 |
| isCustom | Int | 是否自定义 |
| isCoerced | Int | 是否胁迫 |
| hoursStart | Int | 小时开始 |
| hoursEnd | Int | 小时结束 |
| pwdUserNo | Int | 密码用户编号 |
| businessId | Int | 业务ID |
| created_at | String | 创建时间 |
| updated_at | String | 更新时间 |
| api_user | Object | API用户信息 |
| pwdId | Int | 密码ID |
| uid | Int | 用户ID |
| nickname | String | 昵称 |
| lockAlias | String | 锁别名 |
| expireDate | Int | 到期天数 |
| pageNo | Int | 页码 |
| pageSize | Int | 每页数量 |
| pages | Int | 总页数 |
| total | Int | 总数 |
{
"list": [
{
"clientId": "ewKnbqQwANE9pYBuKUz3FLzPOPcrzspO",
"lockOwnerId": 385,
"lockId": 1759,
"keyboardPwdType": 3,
"keyboardPwdStatus": 1,
"startDate": 1711609200000,
"endDate": 1713888000000,
"keyboardPwd": "69030810717",
"keyboardPwdHash": "f5d35453e8619ac00d8e91a1c1b04f26351acd1e",
"addType": 0,
"pwdRight": 0,
"isCustom": 0,
"isCoerced": 2,
"hoursStart": 0,
"hoursEnd": 23,
"pwdUserNo": 0,
"businessId": 0,
"created_at": "2024-03-28T02:00:04.000000Z",
"updated_at": "2024-03-28T02:00:04.000000Z",
"api_user": {
"id": 385,
"account_name": "6666@qq.com"
},
"pwdId": 6602,
"uid": 385,
"nickname": "32223",
"lockAlias": "锁",
"expireDate": 26
}
],
"pageNo": 1,
"pageSize": 20,
"pages": 1,
"total": 1
}即将到期的IC卡列表
请求链接:
/keyUser/listExpireCard请求方式:
POST参数说明:
| 名称 | 类型 | 是否必需 | 示例 | 描述 |
|---|---|---|---|---|
| pageNo | int | N | 1 | 页码 |
| pageSize | int | N | 20 | 每页数量 |
- 返回参数及示例:
| 参数 | 类型 | 描述 |
|---|---|---|
| status | Int | 状态码 |
| statusText | String | 提示信息 |
| content | String | 返回数据 |
| list | Array | IC卡列表 |
| clientId | String | 客户端ID |
| lockOwnerId | Int | 锁所有者ID |
| lockId | Int | 锁ID |
| cardNumber | String | 卡号 |
| startDate | Long | 开始时间 |
| endDate | Long | 结束时间 |
| cardStatus | Int | 卡状态 |
| cardType | Int | 卡类型 |
| cardRight | Int | 卡权限 |
| weekDay | Array | 有效星期 |
| addType | Int | 添加类型 |
| isCoerced | Int | 是否胁迫 |
| cardUserNo | Int | 卡用户编号 |
| businessId | Int | 业务ID |
| created_at | String | 创建时间 |
| updated_at | String | 更新时间 |
| api_user | Object | API用户信息 |
| cardId | Int | 卡ID |
| uid | Int | 用户ID |
| nickname | String | 昵称 |
| lockAlias | String | 锁别名 |
| expireDate | Int | 到期天数 |
| pageNo | Int | 页码 |
| pageSize | Int | 每页数量 |
| pages | Int | 总页数 |
| total | Int | 总数 |
{
"list": [
{
"clientId": "ewKnbqQwANE9pYBuKUz3FLzPOPcrzspO",
"lockOwnerId": 385,
"lockId": 1759,
"cardNumber": "232",
"startDate": 1711333200000,
"endDate": 1712557200000,
"cardStatus": 1,
"cardType": 4,
"cardRight": 0,
"weekDay": [1, 2, 3, 4, 5],
"addType": 1,
"isCoerced": 1,
"cardUserNo": 0,
"businessId": 0,
"created_at": "2024-03-28T02:07:35.000000Z",
"updated_at": "2024-03-28T02:07:35.000000Z",
"api_user": {
"id": 385,
"account_name": "6666@qq.com"
},
"cardId": 5543,
"uid": 385,
"nickname": "v3vgbh",
"lockAlias": "锁",
"expireDate": 11
}
],
"pageNo": 1,
"pageSize": 20,
"pages": 1,
"total": 1
}即将到期的指纹列表
请求链接:
/keyUser/listExpireFingerprint请求方式:
POST参数说明:
| 名称 | 类型 | 是否必需 | 示例 | 描述 |
|---|---|---|---|---|
| pageNo | int | N | 1 | 页码 |
| pageSize | int | N | 20 | 每页数量 |
- 返回参数及示例:
| 参数 | 类型 | 描述 |
|---|---|---|
| status | Int | 状态码 |
| statusText | String | 提示信息 |
| content | String | 返回数据 |
| list | Array | 指纹列表 |
| clientId | String | 客户端ID |
| lockOwnerId | Int | 锁所有者ID |
| lockId | Int | 锁ID |
| fingerprintStatus | Int | 指纹状态 |
| fingerprintNumber | String | 指纹编号 |
| fingerprintType | Int | 指纹类型 |
| startDate | Long | 开始时间 |
| endDate | Long | 结束时间 |
| weekDay | Array | 有效星期 |
| addType | Int | 添加类型 |
| fingerRight | Int | 指纹权限 |
| isCoerced | Int | 是否胁迫 |
| fingerprintUserNo | Int | 指纹用户编号 |
| businessId | Int | 业务ID |
| created_at | String | 创建时间 |
| updated_at | String | 更新时间 |
| api_user | Object | API用户信息 |
| fingerprintId | Int | 指纹ID |
| uid | Int | 用户ID |
| nickname | String | 昵称 |
| lockAlias | String | 锁别名 |
| expireDate | Int | 到期天数 |
| pageNo | Int | 页码 |
| pageSize | Int | 每页数量 |
| pages | Int | 总页数 |
| total | Int | 总数 |
{
"list": [
{
"clientId": "ewKnbqQwANE9pYBuKUz3FLzPOPcrzspO",
"lockOwnerId": 385,
"lockId": 1759,
"fingerprintStatus": 1,
"fingerprintNumber": "fb3d4e32-f212-458c-b08c-a4055d0700ec",
"fingerprintType": 4,
"startDate": 1711333200000,
"endDate": 1712557020000,
"weekDay": [1, 3],
"addType": 1,
"fingerRight": 0,
"isCoerced": 1,
"fingerprintUserNo": 0,
"businessId": 0,
"created_at": "2024-03-28T02:09:19.000000Z",
"updated_at": "2024-03-28T02:09:19.000000Z",
"api_user": {
"id": 385,
"account_name": "6666@qq.com"
},
"fingerprintId": 6969,
"uid": 385,
"nickname": "测试卡-胁迫-2中指2222",
"lockAlias": "锁",
"expireDate": 11
}
],
"pageNo": 1,
"pageSize": 20,
"pages": 1,
"total": 1
}即将到期的人脸列表
请求链接:
/keyUser/listExpireFace请求方式:
POST参数说明:
| 名称 | 类型 | 是否必需 | 示例 | 描述 |
|---|---|---|---|---|
| pageNo | int | N | 1 | 页码 |
| pageSize | int | N | 20 | 每页数量 |
- 返回参数及示例:
| 参数 | 类型 | 描述 |
|---|---|---|
| status | Int | 状态码 |
| statusText | String | 提示信息 |
| content | String | 返回数据 |
| list | Array | 人脸列表 |
| clientId | String | 客户端ID |
| lockOwnerId | Int | 锁所有者ID |
| lockId | Int | 锁ID |
| faceNumber | String | 人脸编号 |
| featureData | String | 特征数据 |
| startDate | Long | 开始时间 |
| endDate | Long | 结束时间 |
| faceType | Int | 人脸类型 |
| status | Int | 状态 |
| cyclicConfig | String | 循环配置(JSON字符串) |
| addType | Int | 添加类型 |
| faceRight | Int | 人脸权限 |
| businessId | Int | 业务ID |
| date | Int | 日期 |
| created_at | String | 创建时间 |
| updated_at | String | 更新时间 |
| faceUserNo | Int | 人脸用户编号 |
| user_info | Object | 用户信息 |
| faceId | Int | 人脸ID |
| uid | Int | 用户ID |
| nickname | String | 昵称 |
| lockAlias | String | 锁别名 |
| expireDate | Int | 到期天数 |
| pageNo | Int | 页码 |
| pageSize | Int | 每页数量 |
| pages | Int | 总页数 |
| total | Int | 总数 |
{
"list": [
{
"clientId": "ewKnbqQwANE9pYBuKUz3FLzPOPcrzspO",
"lockOwnerId": 385,
"lockId": 1759,
"faceNumber": "8728787",
"featureData": "458787",
"startDate": 1711328400000,
"endDate": 1712584800000,
"faceType": 4,
"status": 1,
"cyclicConfig": "[]",
"addType": 1,
"faceRight": 0,
"businessId": 0,
"date": 0,
"created_at": "2024-03-28T02:10:58.000000Z",
"updated_at": "2024-03-28T02:10:58.000000Z",
"faceUserNo": 0,
"user_info": {
"id": 385,
"account_name": "6666@qq.com"
},
"faceId": 19,
"uid": 385,
"nickname": "人2脸名称2w2",
"lockAlias": "锁",
"expireDate": 11
}
],
"pageNo": 1,
"pageSize": 20,
"pages": 1,
"total": 1
}即将到期的掌静脉
请求链接:
/keyUser/listExpirePalmVein请求方式:
POST参数说明:
| 名称 | 类型 | 是否必需 | 示例 | 描述 |
|---|---|---|---|---|
| pageNo | int | N | 1 | 页码 |
| pageSize | int | N | 20 | 每页数量 |
- 返回参数及示例:
| 参数 | 类型 | 描述 |
|---|---|---|
| status | Int | 状态码 |
| statusText | String | 提示信息 |
| content | String | 返回数据 |
| list | Array | 掌静脉列表 |
| clientId | String | 客户端ID |
| lockOwnerId | Int | 锁所有者ID |
| lockId | Int | 锁ID |
| palmVeinNumber | String | 掌静脉编号 |
| startDate | Long | 开始时间 |
| endDate | Long | 结束时间 |
| palmVeinType | Int | 掌静脉类型 |
| weekDay | Array | 有效星期 |
| palmVeinStatus | Int | 掌静脉状态 |
| palmVeinUserNo | Int | 掌静脉用户编号 |
| businessId | Int | 业务ID |
| palmVeinRight | Int | 掌静脉权限 |
| addType | Int | 添加类型 |
| isCoerced | Int | 是否胁迫 |
| created_at | String | 创建时间 |
| updated_at | String | 更新时间 |
| user_info | Object | 用户信息 |
| lock_info | Object | 锁信息 |
| palmVeinId | Int | 掌静脉ID |
| uid | Int | 用户ID |
| nickname | String | 昵称 |
| lockAlias | String | 锁别名 |
| expireDate | Int | 到期天数 |
| pageNo | Int | 页码 |
| pageSize | Int | 每页数量 |
| pages | Int | 总页数 |
| total | Int | 总数 |
{
"list": [
{
"clientId": "TMwurHIlxuRdS7lkiHPdOJlBgWutBoW1",
"lockOwnerId": 11023,
"lockId": 329,
"palmVeinNumber": "28881",
"startDate": 1750299272721,
"endDate": 1750302872000,
"palmVeinType": 2,
"weekDay": [],
"palmVeinStatus": 1,
"palmVeinUserNo": 0,
"businessId": 0,
"palmVeinRight": 0,
"addType": 1,
"isCoerced": 0,
"created_at": "2025-06-19T02:16:33.000000Z",
"updated_at": "2025-06-19T02:16:33.000000Z",
"user_info": {
"id": 11023,
"account_name": "585685@qq.com"
},
"lock_info": {
"btDeviceName": "TMH_ea9acd84050d"
},
"palmVeinId": 1,
"uid": 11023,
"nickname": "掌静脉名称3",
"lockAlias": "啊啊啊",
"expireDate": 1
}
],
"pageNo": 1,
"pageSize": 20,
"pages": 1,
"total": 1
}即将到期的遥控
请求链接:
/keyUser/listExpireRemote请求方式:
POST参数说明:
| 名称 | 类型 | 是否必需 | 示例 | 描述 |
|---|---|---|---|---|
| pageNo | int | N | 1 | 页码 |
| pageSize | int | N | 20 | 每页数量 |
- 返回参数及示例:
| 参数 | 类型 | 描述 |
|---|---|---|
| status | Int | 状态码 |
| statusText | String | 提示信息 |
| content | String | 返回数据 |
| list | Array | 遥控列表 |
| clientId | String | 客户端ID |
| lockOwnerId | Int | 锁所有者ID |
| lockId | Int | 锁ID |
| remoteNumber | String | 遥控编号 |
| mac | String | MAC地址 |
| startDate | Long | 开始时间 |
| endDate | Long | 结束时间 |
| remoteType | Int | 遥控类型 |
| weekDay | Array | 有效星期 |
| electricQuantity | Int | 电量 |
| firmwareInfo | Array | 固件信息 |
| remoteStatus | Int | 遥控状态 |
| created_at | String | 创建时间 |
| updated_at | String | 更新时间 |
| remoteUserNo | Int | 遥控用户编号 |
| businessId | Int | 业务ID |
| remoteRight | Int | 遥控权限 |
| addType | Int | 添加类型 |
| isCoerced | Int | 是否胁迫 |
| user_info | Object | 用户信息 |
| lock_info | Object | 锁信息 |
| remoteId | Int | 遥控ID |
| uid | Int | 用户ID |
| nickname | String | 昵称 |
| lockAlias | String | 锁别名 |
| expireDate | Int | 到期天数 |
| pageNo | Int | 页码 |
| pageSize | Int | 每页数量 |
| pages | Int | 总页数 |
| total | Int | 总数 |
{
"list": [
{
"clientId": "TMwurHIlxuRdS7lkiHPdOJlBgWutBoW1",
"lockOwnerId": 11023,
"lockId": 331,
"remoteNumber": "6",
"mac": "",
"startDate": 1750298760000,
"endDate": 1750329000000,
"remoteType": 2,
"weekDay": [],
"electricQuantity": 0,
"firmwareInfo": [],
"remoteStatus": 1,
"created_at": "2025-06-19T02:07:04.000000Z",
"updated_at": "2025-06-19T02:07:04.000000Z",
"remoteUserNo": 6,
"businessId": 0,
"remoteRight": 0,
"addType": 1,
"isCoerced": 0,
"user_info": {
"id": 11023,
"account_name": "585685@qq.com"
},
"lock_info": {
"btDeviceName": "TMH_d928291e9a14"
},
"remoteId": 2,
"uid": 11023,
"nickname": "555",
"lockAlias": "遥控",
"expireDate": 1
}
],
"pageNo": 1,
"pageSize": 20,
"pages": 1,
"total": 1
}