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

超时时间建议设置为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  | 待检测照片              |
### 请求体示例
```
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[] | 否 | 人脸的位置及人脸属性信息，具体结构如下表。<font color=red>随AI能力发展，该字段会扩充更多的检测能力，字段会随时间增加，请客户做好代码兼容准备</font> 。|
| ∟ x1        | String  | 否 | 人脸位置信息，对应人脸矩形左上角横坐标相对坐标               |
| ∟ y1        | String  | 否 | 人脸位置信息，对应人脸矩形左上角纵坐标相对坐标               |
| ∟ x2        | String  | 否 | 人脸位置信息，对应人脸矩形右下角横坐标相对坐标               |
| ∟ y2        | String  | 否 | 人脸位置信息，对应人脸矩形右下角纵坐标相对坐标               |
| ∟ gender    | String  | 否 | 人脸性别，男性返回male，女性返回female，不可识别时返回空值   |
| ∟ age       | Integer | 否 | 人脸年龄，返回具体年龄数值，不可识别时返回空值               |
| ∟ type      | String  | 否 | 人脸类型 , normal-普通  cartoon-卡通脸。<br>仅判断人脸照是否被卡通/漫画化，如果传的是纯卡通漫画照片，那么人脸个数会直接为0。 |
| ∟ sizeRatio | String  | 否 | 人脸占比百分比。<br>用于判断头像质量，正常的人像照片人脸占比在8-15%。若数值在4%及以下就属于质量不佳的人脸照片，建议让用户重新上传或进入您自己的人工审核流程 |
| ∟ maskType  | String  | 否 | mask(有遮挡)，normal（无遮挡）。<br>判断人脸是否有遮挡，可以用于判断用户是否佩戴口罩、纱巾等综合性遮挡场景 |
| ∟ glasses   | String  | 否 | 人脸戴眼镜，normal(无眼镜)、 glasses(普通眼镜)、 sunglasses（墨镜） |
| ∟ beautyScore | String  | 否 | 颜值分，范围0-1，分数越高，颜值越高
### 响应体实例：
```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)