Skip to content

获取锁名下人脸列表 ​

https://cnapi.sciener.com/v3/face/list

管理员或授权管理员查看这把锁上,添加的所有人脸。

1 HTTP请求方法及示例 ​

javascript
curl --location -g --request GET 'https://cnapi.sciener.com/v3/face/list?clientId=fd2ff35ee3d8424c8665c07b7b9a7f45&accessToken=780f7671b6e6be3010d9787f19207aca&lockId=1719&pageNo=1&pageSize=20&date=1625025703000'

2 参数说明 ​

名称类型是否必需描述
clientIdStringY创建应用分配的client_id
accessTokenStringY访问令牌,通过获取访问令牌接口获取
lockIdIntY锁ID,由锁初始化接口生成
searchStrStringN搜索串(名称模糊匹配)
pageNoIntY页码,从1开始
pageSizeIntY每页数量,默认20,最大200
dateLongY当前时间(时间戳,单位毫秒)

3 返回参数及示例 ​

参数类型描述
listJSONArray记录列表
pageNoInt页码,从1开始
pageSizeInt每页数量,最大200
pagesInt总页数
totalInt总条数

列表中的对象

参数类型描述
faceIdInt人脸ID
lockIdInt锁ID
nameString人脸名称
faceNumberString人脸编号
statusString状态:1-正常、2-已失效、3-待生效
nicknameString添加者昵称
useridString添加者uid
typeInt人脸类型:1-普通、4-循环
startDateLong有效期开始时间(时间戳,单位毫秒)
endDateLong有效期结束时间(时间戳,单位毫秒)
cyclicConfigJSONArray循环时间设置,目前只支持每天开始时间和结束时间一样的设置,示例: {"startTime":480, "endTime":1080,"weekDay":[1,2,3,4,5]} 表示周一到周五8:00到18:00有效
createDateLong创建时间(时间戳,单位毫秒)
{
    "list": [
        {
            "faceId": 224242,
            "lockId": 163377,
            "faceNumber": "44668054142981",
            "faceType": 1,
            "faceName":"妈妈的正脸",
            "startDate": 1625025703000,
            "endDate": 1645025703000,
            "createDate": 1625025703000,
            "nick": "alexa@google.com"
        }
    ],
    "pageNo":1,
    "pageSize":20,
    "pages":1,
    "total":1
}