1. 微服务模块
微服务模块
1.1. 上传文件(可用于人脸比对)
基础信息
路径: /v1/api/misc/file/upload
请求方法: POST
请求参数
Headers:
名称 | 值 | 必须 | 备注 |
---|---|---|---|
Content-Type | multipart/form-data | 是 |
Query:
名称 | 值 | 必须 | 备注 |
---|---|---|---|
type | 是 | 1:导入文件,指各类批量导入,临时上传的文件,2:认证文件,用于将来可能出现需要做认证的一些场景,如身份证等信息,预留参数,一般不用 |
表单:
名称 | 值 | 必须 | 类型 | 备注 |
---|---|---|---|---|
file | 是 | file | 上传文件,此接口适用于传输非人脸以外的文件类型 |
返回数据
Headers:
名称 | 值 | 必须 | 备注 |
---|---|---|---|
content-type | application/json;charset=UTF-8 | 否 |
Body:
名称 | 类型 | 必须 | 默认值 | 备注 |
---|---|---|---|---|
code | integer | 否 | 返回值code | |
msg | string | 否 | 返回值消息 | |
data | object | 否 | 具体的返回值 | |
|─uri | string | 是 | 上传返回的uri |
响应示例:
{
"code": 0,
"msg": "成功",
"data": {
"uri": "Z3NwOi8vbWVnY29ubmVjdC1mYWNlLWNhcA==-d50604584dbb4fa0b660"
}
}
1.2. 入库质量检测
基础信息
路径: /v1/api/misc/file/qualityJudge
请求方法: POST
请求参数
Headers:
名称 | 值 | 必须 | 备注 |
---|---|---|---|
Content-Type | multipart/form-data | 是 |
表单:
名称 | 值 | 必须 | 类型 | 备注 |
---|---|---|---|---|
file | 是 | file | 上传人脸图片文件质量检测,接口内部包含了人脸质量判断,不做上传,只是个质量判断,最大10m,支持格式:jpg,jpeg,bmp,png,JPG,JPEG,BMP,PNG |
返回数据
Headers:
名称 | 值 | 必须 | 备注 |
---|---|---|---|
content-type | application/json;charset=UTF-8 | 否 |
Body:
名称 | 类型 | 备注 |
---|---|---|
code | integer | 返回值code |
msg | string | 返回值消息 |
data | object | 具体的返回值 |
响应示例:
{
"msg": "人脸分析错误,可能是图片人脸质量较差或者没有人脸",
"code": 202413
}