获取最近访客的到访列表

接口功能

获取指定时间段内的访客到访列表。

请求地址

https://open.qly.cmviot.cn/v3/open/api/ai/visitorStats/queryVisitorList

请求方式

POST，需要鉴权

请求参数

参数名称	参数类型	是否必需	参数含义	说明
storeId	String	N	节点id	为空时查询根节点
startTime	String	N	抓拍开始时间	格式：yyyy-MM-dd HH:mm:ss，不可晚于当前时间。为空，默认查所有
endTime	String	N	抓拍截止时间	格式：yyyy-MM-dd HH:mm:ss，不可早于开始时间。开始/结束均为空，默认查所有
sex	int	N	顾客性别	-1：未知，0：女，1：男
isUnderLine	boolean	N	是否查询直接级联企业节点	false：否（为空默认按否处理） true：是
page	int	N	页码	默认1
pageSize	int	N	每页大小	默认30

请求示例

{
    "storeId":"",
    "sex":1,
    "startTime":"2021-04-01 09:18:33",
    "endTime":"2021-04-19 10:12:51",
    "page": 1,
    "pageSize": 20
}

响应参数

参数名称	参数类型	参数含义	说明
resultCode	String	响应码	参考响应码定义
resultMsg	String	响应描述
total	int	记录数
page	int	当前页
pageSize	int	页大小
data	List<VisitorInfo>	响应数据

VisitorInfo 对象模型

名称	类型	参数含义	说明
age	int	年龄
captureCount	int	抓拍次数
capturePictureUrl	String	抓拍图片地址	有效期一天，请及时存储
cutPictureUrl	String	裁剪图片地址	有效期一天，请及时存储
deviceId	String	设备id
deviceName	String	设备名称
maskStatus	int	是否带口罩	-1：未识别 0：no 1：yes
pictureObjectId	String	图片id
pictureObjectUrl	String	访客底库照片，为该访客首次抓拍照片的图片地址	有效期一天，请及时存储
realName	String	姓名
recentCapture	String	最近抓拍时间
recordId	int	记录id
sex	int	性别	-1：未知，0：女，1：男
storeId	String	节点id
storeName	String	节点名称
visitorId	int	访客id
visitorNumber	String	访客编号

响应示例

{
  "resultCode": "000000",
  "resultMsg": "成功",
  "data": [
    {
      "visitorId": 95,
      "storeId": "722758970340929536",
      "storeName": "",
      "realName": "",
      "sex": -1,
      "age": -1,
      "pictureObjectId": "cut-picture/e532130f48ee475eaf6cdf9d0277f67c.jpg",
      "pictureObjectUrl": "https://scvp-ai-dev.oss-cn-beijing.aliyuncs.com/cut-picture/e532130f48ee475eaf6cdf9d0277f67c.jpg?Expires=1619666659&OSSAccessKeyId=LTAIRqmKaNxHmwJk&Signature=Q1ckvrIACTs7pUPWZFQOJbAUciY%3D",
      "recentCapture": "2021-04-27 18:10:53",
      "captureCount": 2,
      "deviceId": "20034080881328000001",
      "deviceName": "",
      "recordId": 36,
      "visitorNumber": "10128",
      "maskStatus": 1
    }
  ],
  "total": 1,
  "page": 1,
  "pageSize": 30
}