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
|─url string 是 上传返回的url

响应示例:

{
  "code": 0,
  "msg": "成功",
  "data": {
    "uri": "Z3NwOi8vbWVnY29ubmVjdC1mYWNlLWNhcA==-d50604584dbb4fa0b660"，
    "url": "http://IP/v1/storage/download/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
}

1.3. 删除上传文件

基础信息

Path： /v1/api/misc/file/delete

Method： POST

请求参数

Headers

参数名称 参数值 是否必须 备注
Content-Type application/json 是

Body

名称 类型 必须 默认值 备注
uri string 是 上传文件返回的uri

Body示例:

{"uri":"Z3NwOi8vd2stZmFjZS1jcm9wL2JlZjQ5ZGIxLTJlNDAtNGY4OC05MmIzLTY3YWM4NTAyMDc3Yw=="}

返回数据

Headers:

名称 值 必须 备注
content-type application/json;charset=UTF-8 否

Body

名称 类型 必须 默认值 备注
code integer 否 状态码
msg string 否 状态描述

响应示例:

{
"code": 0,
"msg": "成功"
}

1.4. 获取视频文件播放时长

基础信息

Path： /v1/api/misc/video/getVideoInfo

Method： POST

请求参数

Headers

参数名称 参数值 是否必须 备注
Content-Type application/json 是

Body

名称 类型 必须 默认值 备注
uri string 是 上传视频文件返回的uri

Body示例:

{"uri":"Z3NwOi8vd3Vrb25n-f2e4d2de6700fce2200780475f3d740e.mkv"}

返回数据

Headers:

名称 值 必须 备注
content-type application/json;charset=UTF-8 否

Body

名称 类型 必须 默认值 备注
code integer 否 状态码
msg string 否 状态描述
duration long 是 视频文件时长（毫秒）

响应示例:

{
  "code": 0,
  "data": {
    "duration": 7073800
  },
  "msg": "成功"
}

results matching ""

    No results matching ""