查询访客详情
接口功能
获取指定访客的详细数据
请求地址
https://open.qly.cmviot.cn/v3/open/api/ai/visitorStats/queryVisitorInfo请求方式
POST,需要鉴权
请求参数
| 参数名称 | 参数类型 | 是否必需 | 参数含义 | 说明 |
|---|---|---|---|---|
| storeId | String | Y | 节点 id | 使用访客列表结果集当中的 storeId |
| visitorId | int | Y | 访客 id | 使用访客列表接口中的 visitorId,与 storeId 需匹配 |
请求示例
json
{
"storeId": "719058304946032644",
"visitorId": 3
}响应参数
| 参数名称 | 参数类型 | 参数含义 | 说明 |
|---|---|---|---|
| resultCode | String | 响应码 | 参考响应码定义 |
| resultMsg | String | 响应描述 | |
| data | Object | 响应数据 |
data 数据模型
| 名称 | 类型 | 参数含义 | 说明 |
|---|---|---|---|
| age | int | 年龄 | |
| captureCount | int | 抓拍次数 | |
| deviceName | String | 设备名称 | |
| firstCaptureTime | String | 首次抓拍时间 | |
| maskStatus | int | 状态 | -1:未识别 0:no 1:yes |
| pictureObjectId | String | 图片 id | |
| pictureObjectUrl | String | 图片地址 | 有效期一天,请及时存储 |
| realName | String | 姓名 | |
| recordVoList | List<RecordDetail> | 记录列表 | |
| sex | int | 性别 | -1:未知,0:女,1:男 |
| storeId | String | 节点 id | |
| visitorNumber | String | 访客编号,五位不重复 |
RecordDetail 对象模型
| 名称 | 类型 | 参数含义 | 说明 |
|---|---|---|---|
| capturePictureObjId | String | 抓拍图片 id | |
| capturePictureObjUrl | String | 抓拍图片地址 | 有效期一天,请及时存储 |
| captureTime | String | 抓拍时间 | |
| cutPictureObjId | String | 人脸截图 objId | |
| cutPictureUrl | String | 人脸截图地址 | 有效期一天,请及时存储 |
| deviceId | String | 设备 id | |
| storeId | String | 节点 id | |
| storeName | String | 节点名称 | |
| visitorFaceId | String | 访客人脸 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"
}
]
}
}