获取锁名下IC卡列表
https://euapi.ttlock.com/v3/identityCard/list
管理员或授权管理员查看这把锁上添加的所有IC卡。
1 HTTP请求方法及示例
javascript
curl --location -g --request GET 'https://euapi.ttlock.com/v3/identityCard/list?clientId=fd2ff35ee3d8424c8665c07b7b9a7f45&accessToken=780f7671b6e6be3010d9787f19207aca&lockId=1719&pageNo=1&pageSize=20&date=1625025703000'2 参数说明
| 名称 | 类型 | 是否必需 | 描述 |
|---|---|---|---|
| clientId | String | Y | 创建应用分配的client_id |
| accessToken | String | Y | 访问令牌,通过获取访问令牌接口获取 |
| lockId | Int | Y | 锁ID,由锁初始化接口生成 |
| searchStr | String | N | 搜索关键词,通过IC卡名称模糊搜索 |
| pageNo | Int | Y | 页码,从1开始 |
| pageSize | Int | Y | 每页数量,默认20,最大200 |
| orderBy | Int | Y | 排序方式:0-按名称正序、1-按生成时间倒序、2-按名称倒序 |
| date | Long | Y | 当前时间(时间戳,单位毫秒) |
3 返回参数及示例
| 参数 | 类型 | 描述 |
|---|---|---|
| list | JSONArray | 记录列表 |
| pageNo | Int | 页码,从1开始 |
| pageSize | Int | 每页数量,最大200 |
| pages | Int | 总页数 |
| total | Int | 总条数 |
列表中的对象
| 参数 | 类型 | 描述 |
|---|---|---|
| cardId | Int | IC卡ID |
| lockId | Int | 锁ID |
| cardNumber | String | IC卡号 |
| cardName | String | IC卡名称 |
| startDate | Long | 有效期开始时间(时间戳,单位毫秒) |
| endDate | Long | 有效期结束时间(时间戳,单位毫秒) |
| createDate | Long | 创建时间(时间戳,单位毫秒) |
| senderUsername | String | 发送者用户名 |
| cardType | Int | 卡类型:1-普通卡、4-循环 |
| cyclicConfig | JSONArray | 循环时间设置,目前只支持每天开始时间和结束时间一样的设置,示例: [{"weekDay":1, "startTime":480,"endTime":1080},{"weekDay":2, "startTime":480,"endTime":1080}] 表示周一和周二8:00到18:00有效 |
{
"list": [
{
"cardId": 124242,
"lockId": 163377,
"cardNumber": "1723612378",
"cardName":"妈妈的卡",
"cardType": 1,
"startDate": 1625025703000,
"endDate": 1645025703000,
"createDate": 1625025703000,
"senderUsername": "alexa@google.com"
}
],
"pageNo":1,
"pageSize":20,
"pages":1,
"total":1
}