Skip to content

查询访客详情

接口功能

获取指定访客的详细数据

请求地址

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

请求方式

POST,需要鉴权

请求参数

参数名称参数类型是否必需参数含义说明
storeIdStringY节点 id使用访客列表结果集当中的 storeId
visitorIdintY访客 id使用访客列表接口中的 visitorId,与 storeId 需匹配

请求示例

json
{
  "storeId": "719058304946032644",
  "visitorId": 3
}

响应参数

参数名称参数类型参数含义说明
resultCodeString响应码参考响应码定义
resultMsgString响应描述
dataObject响应数据

data 数据模型

名称类型参数含义说明
ageint年龄
captureCountint抓拍次数
deviceNameString设备名称
firstCaptureTimeString首次抓拍时间
maskStatusint状态-1:未识别
0:no
1:yes
pictureObjectIdString图片 id
pictureObjectUrlString图片地址有效期一天,请及时存储
realNameString姓名
recordVoListList<RecordDetail>记录列表
sexint性别-1:未知,0:女,1:男
storeIdString节点 id
visitorNumberString访客编号,五位不重复

RecordDetail 对象模型

名称类型参数含义说明
capturePictureObjIdString抓拍图片 id
capturePictureObjUrlString抓拍图片地址有效期一天,请及时存储
captureTimeString抓拍时间
cutPictureObjIdString人脸截图 objId
cutPictureUrlString人脸截图地址有效期一天,请及时存储
deviceIdString设备 id
storeIdString节点 id
storeNameString节点名称
visitorFaceIdString访客人脸 id

响应示例

json
{
  "resultCode": "000000",
  "resultMsg": "成功",
  "data": {
    "storeId": "722758970340929536",
    "realName": "",
    "maskStatus": 1,
    "sex": -1,
    "pictureObjectId": "cut-picture/5101b44bab2c458783f817b8b8f2c965.jpg",
    "pictureObjectUrl": "https://scvp-ai-dev.oss-cn-beijing.aliyuncs.com/cut-picture/5101b44bab2c458783f817b8b8f2c965.jpg?Expires=1619666969&OSSAccessKeyId=LTAIRqmKaNxHmwJk&Signature=aqLQR%2Bj3TFHbxcNYdBBQ9v84bgw%3D",
    "captureCount": 35,
    "firstCaptureTime": "2021-04-27 10:41:25",
    "deviceName": "",
    "visitorNumber": "10128",
    "recordVoList": [
      {
        "storeId": "722758970340929536",
        "storeName": "",
        "visitorFaceId": "539573a7-f8bb-4a0a-be88-e93c6342ecc0",
        "capturePictureObjId": "vre-capture/de3db30537ea4d4a96a913009991cb56.jpg",
        "cutPictureObjId": "cut-picture/3c2759746a5f4827897baa50a9c1e85e.jpg",
        "deviceId": "20034080881328000001",
        "createTime": "2021-04-28 21:45:39"
      }
    ]
  }
}