人员查询
接口功能
TEXT
人员查询请求地址
TEXT
https://open.qly.cmviot.cn/v3/open/api/ai/person/list请求方式
TEXT
POST,需要鉴权请求参数
| 参数名称 | 参数类型 | 是否必需 | 参数含义 | 说明 |
|---|---|---|---|---|
| aiPersonSetId | int | Y | 监控名单ID | |
| queryKey | string | N | 搜索关键字,姓名、手机号 | |
| sex | int | N | 0:女 1:男 | |
| page | int | N | 分页参数-页数 | 默认1 |
| pageSize | int | N | 分页参数-每页条数 | 默认30 |
请求示例
json
{
"aiPersonSetId": 26,
"queryKey": "xxxx",
"sex": 1,
"page": 1,
"pageSize": 30
}响应参数
| 参数名称 | 参数类型 | 参数含义 | 说明 |
|---|---|---|---|
| resultCode | String | 响应码 | 参考响应码定义 |
| resultMsg | String | 响应描述 | |
| total | Integer | 记录数 | 分页查询时使用 |
| page | Integer | 当前页 | 分页查询时使用 |
| pageSize | Integer | 页大小 | 分页查询时使用 |
| data | List | 响应数据 | 响应数据 |
data数据模型
| 参数名称 | 参数类型 | 参数含义 | 说明 |
|---|---|---|---|
| aiPersonId | int | 监控人员id | |
| cellphone | string | 电话号码 | |
| realName | string | 名字 | |
| sex | int | 性别 | 0:女 1:男 |
| certificateType | int | 证件类型 | 0:身份证,1:护照,2:学生证,3:警官证,4:驾驶证 |
| identityCard | string | 证件号码 | |
| age | int | 年龄 | |
| birthday | date | 出生日期 | yyyy-MM-dd HH:mm:ss |
| nation | string | 国籍 | |
| nationality | string | 民族 | |
| occupation | string | 职业 | |
| personPictureVos | PersonPictureVo[] | 人员图片集合 | 至少一个 |
PersonPictureVo
| 参数名称 | 参数类型 | 参数含义 | 说明 |
|---|---|---|---|
| aiPersonPictureId | int | 图片ID | |
| pictureUrl | string | 下载地址 | |
| frontCover | boolean | 是否是封面图 | |
| pictureObjectId | string | 图片objId |
响应示例
json
{
"resultCode": "000000",
"resultMsg": "成功",
"total": 1,
"page": 1,
"pageSize": 30,
"data": [{
"aiPersonId": 63767,
"realName": "熊远婷3修改",
"sex": 1,
"cellphone": "18243821392",
"birthday": "1992-03-03 00:00:00",
"age": 31,
"certificateType": 4,
"identityCard": "500109192202026321",
"nation": "中国",
"nationality": "土家族",
"occupation": "渔民",
"personPictureVos": [{
"aiPersonPictureId": 65575,
"pictureUrl": "https://xxxxxx",
"pictureObjectId": "yywsai-test/person-picture/6312a38445a94becb0815bcb34a41748.jpg",
"frontCover": true
},
{
"aiPersonPictureId": 65577,
"pictureUrl": "https://xxxxxxx",
"pictureObjectId": "yywsai-test/person-picture/6312a38445a94becb0815bcb34a41748.jpg",
"frontCover": false
},
{
"aiPersonPictureId": 65579,
"pictureUrl": "https://xxxxxxx",
"pictureObjectId": "yywsai-test/person-picture/6312a38445a94becb0815bcb34a41748.jpg",
"frontCover": false
}
]
}]
}