搜索用户列表
更新时间：2021-06-24
接口描述
本接口用于从EVS中心静态人脸库中搜索用户。
请求（Request）
请求URL
GET /v1/faceuser?marker={marker}&maxSize={maxSize}&databaseId={databaseId}&name={name}&IDCardNo={IDCardNo}
请求头域
除公共头域外，无其它特殊头域。
请求体
| 参数名称 | 类型 | 是否必需 | 描述 |
|---|---|---|---|
| marker | String | 否 | 人脸库用户ID，value可以不填，但key必须存在 |
| maxSize | String | 是 | 查询结果最大条数 |
| databaseId | String | 是 | 人脸库ID |
| IDCardNo | String | 否 | 人脸库用户身份证号 |
| name | String | 否 | 人脸库用户名称，最左匹配查询 |
响应（Response）
响应头域
除公共头域外，无其它特殊头域。
响应体
| 参数名称 | 类型 | 描述 |
|---|---|---|
| data | Array | 用户信息 |
| + databaseId | String | 人脸库ID |
| + userId | String | 人脸库用户ID |
| + IDCardNo | String | 人脸库用户身份证号 |
| + name | String | 人脸库用户名称 |
| + gender | String | 用户性别，MALE/FEMALE/OTHER |
| + Tel | String | 人脸库用户名称手机号 |
| + address | String | 人脸库用户地址 |
| + picsPreview | String | 人脸库用户照片列表 |
| marker | String | 本次查询的起点 |
| nextMarker | String | 下一次查询的起点，为空表示已经返回所有结果 |
| isTruncated | Boolean | 指明是否所有查询都返回了；false-本次已经返回所有结果，true-本次还没有返回所有结果 |
示例
请求示例
GET /v1/faceuser?marker&maxSize=5&databaseId=dbf-marh85yxhzwwufyq HTTP/1.1
x-bce-date: 2020-03-25T09:28:13Z
host: evs.bj.baidubce.com
content-type: application/json
authorization: bce-auth-v1/e8e4a9ced6794355a9a1b8a20b58d37b/2020-03-25T09:28:13Z/1800/content-type;host;x-date/4a1692dc4bab84f5801f79ea0c1fece3601cf73ecd94409d2a94b3942b971715响应示例
HTTP/1.1 200 OK
Transfer-Encoding: chunked
x-bce-request-id: 012b9747-f13a-4a2c-a488-02b221844dca
Cache-Control: no-cache
Server: BWS
Date: Tue, 24 Mar 202 013:34:07 GMT
Content-Type: application/json;charset=UTF-8
{
"data": [
{
"userId": "fui-marhd2euedk2uyun",
"databaseId": "dbf-marh85yxhzwwufyq",
"name": "张三",
"gender": "MALE",
"Tel": "13011111111",
"IDCardNo": "110105200001258150",
"address": "中国北京市海淀区小营西路113号",
"description": "一个新人",
"picsPreview": [
"http://bucket.bj.bcebos.com/dbf-maqtvbg8e1bipyi5/fui-marhd2euedk2uyun/user1-1.jpg?authorization=xxx",
"http://bucket.bj.bcebos.com/dbf-marh85yxhzwwufyq/fui-marhd2euedk2uyun/user1-2.jpg?authorization=xxx"
]
}
],
"marker": "fui-marhd2euedk2uyun",
"isTruncated": false
}错误码
参考公共错误码