文档

测试

请勿掉调用

websocket测试

POST

http://IP:端口/IqaForCapture

接口描述

该接口用于评价抓拍机的抓拍人脸质量。

请求头

参数名

类型

描述

必填

Content-Type

string

application/json

必填

Authorization

string

Authorization目前按照5a98c5facb5d321e8b4949afd8a27dfc2dcc431181d68c9d3117b32fee1231ea写死即可.

必填

请求参数

参数名

类型

描述

必填

TaskID

string

一次请求一个TaskID,必填

必填

Images

array

一个图片对应一个字典,必填

必填

ImageID

string

每一张图片对应一个TaskID

必填

StoragePath

string

http://10.8.202.157:9999/group1/M00/00/08/CgjKnV2tYeKAX0tsAAByhp8N6xA802.jpg , url即可, 和Data一起的话,该项优先

必填

Data

string

base64编码, 可以加data:image/jpg;base64,也可以不加 StoragePath和Data 二选一

可选

响应参数

参数名

类型

描述

必填

TaskID

string

一次请求一个TaskID,必填

必填

LocalTime

string

返回时的时间戳

必填

Results

array

结果列表.一个字典代表一张图片的结果

必填

ImageID

string

请求参数里面的ImageID,用于标记对应返回结果

必填

Result

dict/map

评价结果

必填

pupillary_distance

float

人脸瞳距,单位是像素,该值越大代表抓拍质量越好,最主要的参数.

必填

coped_image_shape

array

检测的人脸区域大小,算法内部判断是要求大于30*30

必填

roll

整数,角度

人脸姿态的翻滚角

必填

pitch

整数,角度

人脸姿态的俯仰角

必填

yaw

整数,角度

人脸姿态的偏航角,

必填

cop_time

float

检测时间

必填

hist_var

float

直方图方差,暂时不需要关注

必填

hist_mean

float

直方图均值,该值应该在[95,150]之间. 在区间内,越大越好.

必填

result_accesment

dict/map

必填

is_no_face

bool

是否检测到脸

必填

is_pupillary_distance_lt_25

bool

是否大于25px

必填

is_too_small

bool

人脸是否过小

必填

is_overexposure

bool

是否过曝光

必填

is_underexposure

bool

是否欠曝光

必填

说明 / 示例

请看测试项.可以直接测试接口请求json ```json { "TaskID": "12323423", "Images":[{ "ImageID": "12312", "StoragePath": "http://10.8.202.157:9999/group1/M00/00/08/CgjKnV2tYeKAX0tsAAByhp8N6xA802.jpg" }, { "ImageID": "12311", "StoragePath": "http://10.8.202.157:9999/group1/M00/00/08/CgjKnV2tYeKAX0tsAAByhp8N6xA802.jpg" }] } ``` 正常返回json ```json { "TaskID": "12323423", "Results": [ { "ImageID": "12312", "Result": { "coped_image_shape": [ 298, 210, 3 ], "roll": -8, "cop_time": 0.0006656646728515625, "result_accesment": { "is_no_face": false, "is_pupillary_distance_lt_25": false, "is_too_small": false, "is_overexposure": false, "is_underexposure": false }, "hist_var": 52.78565960911019, "hist_time": 0.001438140869140625, "msg": "Success", "yaw": -30, "hist_mean": 115.02788430808565, "pupillary_distance": 31.81450080871582, "status_code": 0 }, } ], "LocalTime": "20200527112806" } ```

该接口使用逻辑

该接口用于人脸质量评价 ```json "result_accesment": { "is_no_face": false, "is_pupillary_distance_lt_25": false, "is_too_small": false, "is_overexposure": false, "is_underexposure": false } ``` 以上只要有一项是正,就不能拿去注册.这是必做功能. 也可以只看status_code=0时，为校验通过。是等价的。

错误码

{"status_code": -1 , "msg": u"加载图片出现了问题"}以下省略key -2 u"检测不到人脸" -10 u"您距离镜头太远了" -3 u"您拍照的地方太亮了" -4 u"您拍照的地方太暗了" -5 u"请勿低头或抬头,如有佩戴眼镜请摘下眼镜" -6 u"请勿摇头,如有佩戴眼镜请摘下眼镜" -7 u"请勿歪头,如有佩戴眼镜请摘下眼镜"

上一篇 liveness-detect