接口描述

请求路径：http://ai-tech.apigw-gz.didiyunapi.com/kouzhaodetect 请求方法：POST

输入参数

参数名称	必选	默认值	描述
appname	是	com.didi.face-detection-mask.ddy	认证时使用，Appname为默认即可
pid	是	200152300	认证时使用，pid为默认即可
is_position	否	0	是否返回人脸的位置坐标，1表示返回，0是不需要
image	是	图片的base64编码	放在body里，key为image，value为图片的base64编码

输出参数

参数名称	类型	描述
err_no	int	识别状态，0表示成功，非0表示异常 详见状态码
err_msg	string	“success”表示成功，其它错误提示
logid	long	方便排查后端错误原因
data	json	请求返回的数据,详见数据注解

数据注解

参数名称	类型	描述
candidate	数组	包含多个人脸及口罩信息
driver	int	是否为司机标识，1为是，0为否
mask	int	是否有戴口罩，1为有人脸戴口罩，0为检测不到人脸，-1为有人脸没检测到口罩
location	json	图片中人脸框的坐标,左上left、top，右下right、bot

状态码

参数名称	描述
0	检测成功
-6101	参数错误
-6102	内部错误
-6103	后端队列已满
-6104	其他错误
-6105	识别错误
-6106	载入图像错误
-6107	获取检测结果错误
-6108	识别引擎重置错误

示例

请求：

curl -X POST 'http://ai-tech.apigw-gz.didiyunapi.com/kouzhaodetect?appname=com.didi.face-detection-mask.ddy&pid=200152300' -H 'Authorization: AppCode  ACDDo8xS5YNGtswRcNbsbVoaeg3MT1ET' -H 'Content-Type: application/json' -H 'Postman-Token: 9fa58c34-21ad-4e15-a131-3576750ed21e' -H 'cache-control: no-cache' -d '{"image":"imagebase64encode“}‘

输出：

{
    "data": {
        "candidate": [{
            "driver": 0,
            "location": {
                "bot": 338.1216125488281,
                "left": 146.8063964843750,
                "right": 304.3013000488281,
                "top": 126.1318588256836
            },
            "mask": 1
        }, {
            "driver": 1,
            "location": {
                "bot": 443.6951599121094,
                "left": 903.3527221679688,
                "right": 1126.237915039062,
                "top": 128.5838928222656
            },
            "mask": 1
        }, {
            "driver": 0,
            "location": {
                "bot": 242.0659027099609,
                "left": 645.1583862304688,
                "right": 739.9298706054688,
                "top": 136.1573028564453
            },
            "mask": 1
        }, {
            "driver": 0,
            "location": {
                "bot": 149.5413665771484,
                "left": 445.2557983398438,
                "right": 516.5772705078125,
                "top": 65.47285461425781
            },
            "mask": -1
        }]
    },
    "err_msg": "success",
    "err_no": 0,
    "logid": 2412492646
}