检测和返回图片中人脸的坐标位置，以及面部特征的常见属性。

## 接口说明

超时时间建议设置为8S，减少因图片下载时间过长而导致的检测失败

### 鉴权说明

易盾信息认证服务使用签名方法对接口进行鉴权，所有接口每一次请求都需要包含签名信息（signature参数），以验证用户身份，防止信息被恶意篡改。目前支持MD5，SHA1，SHA256，SM3几种加密算法，详细信息，请参见接口鉴权 (https://support.dun.163.com/documents/391676076156063744?docId=622572798032863232)

## 请求
### 请求地址
名称 | 值
HTTP URL | http://verify.dun.163.com/v1/facedetect/check (http://verify.dun.163.com/v1/facedetect/check)
HTTP Method | POST

### 请求头
名称 | 类型 | 必填 | 描述
Content-Type | String | 是 | 固定值："application/x-www-form-urlencoded"

### 请求参数

请求参数由请求公共参数和请求业务参数两部分组成，通用参数见请求通用字段 (https://support.dun.163.com/documents/391676076156063744?docId=622573136165068800)

名称 | 类 型 | 必填 | 最大长度 | 描述
picType | Number | 是 | 4 | 图片类型：1-URL，2-BASE64
picImage | String | 是 | 256或10M | 待检测照片

### 请求体示例
Code:
picType=1&picImage=xxx&version=v1&businessId=xxx&timestamp=1638180222235&nonce=xxx&secretId=xxx&signature=xxx

## 响应
### 响应结果

响应字段如下，响应通用字段已省略，详细见响应公共字段 (https://support.dun.163.com/documents/391676076156063744?docId=624032228347863040)

参数名称 | 类型 | 必须返回 | 描述
status | Number | 是 | 检测结果，1-检测成功， 2-检测失败，3-图片下载失败，4-图片格式错误，5-其他错误，请联系客服
requestId | String | 是 | 本次请求数据标识，可以根据该标识查询数据最新结果
faceNumber | Number | 是 | 人脸数量
isPayed | Number | 是 | 本次请求是否收费标识，1代表收费，0代表不收费
faceLocations | Object[] | 否 | 人脸的位置及人脸属性信息，具体结构如下表。随AI能力发展，该字段会扩充更多的检测能力，字段会随时间增加，请客户做好代码兼容准备 。
∟ x1 | String | 否 | 人脸位置信息，对应人脸矩形左上角横坐标相对坐标
∟ y1 | String | 否 | 人脸位置信息，对应人脸矩形左上角纵坐标相对坐标
∟ x2 | String | 否 | 人脸位置信息，对应人脸矩形右下角横坐标相对坐标
∟ y2 | String | 否 | 人脸位置信息，对应人脸矩形右下角纵坐标相对坐标
∟ gender | String | 否 | 人脸性别，男性返回male，女性返回female，不可识别时返回空值
∟ age | Integer | 否 | 人脸年龄，返回具体年龄数值，不可识别时返回空值
∟ type | String | 否 | 人脸类型 , normal-普通  cartoon-卡通脸。仅判断人脸照是否被卡通/漫画化，如果传的是纯卡通漫画照片，那么人脸个数会直接为0。
∟ sizeRatio | String | 否 | 人脸占比百分比。用于判断头像质量，正常的人像照片人脸占比在8-15%。若数值在4%及以下就属于质量不佳的人脸照片，建议让用户重新上传或进入您自己的人工审核流程
∟ maskType | String | 否 | mask(有遮挡)，normal（无遮挡）。判断人脸是否有遮挡，可以用于判断用户是否佩戴口罩、纱巾等综合性遮挡场景
∟ glasses | String | 否 | 人脸戴眼镜，normal(无眼镜)、 glasses(普通眼镜)、 sunglasses（墨镜）
∟ beautyScore | String | 否 | 颜值分，范围0-1，分数越高，颜值越高

### 响应体实例：
Code (json):
{
	"msg": "ok",
	"result": {
		"faceLocations": [{
			"glasses": "normal",
			"maskType": "normal",
			"gender": "female",
			"sizeRatio": "30.46%",
			"y1": "0.1432",
			"x1": "0.1259",
			"y2": "0.5229",
			"x2": "0.928",
			"type": "normal",
			"age": "23",
                        "beautyScore": "0.57"
		}],
		"requestId": "ce21453dc6c94594999d4a852b7dff95",
		"isPayed": 1,
		"faceNumber": 1,
		"status": 1
	},
	"code": 200
}

### 响应返回码

响应返回码见：响应返回码 (https://support.dun.163.com/documents/391676076156063744?docId=624032338595143680)