用户同时上传两张人脸照片，识别两张人脸的相似度，并判断是否为同一人
## 接口说明

**<font color = red>使用建议：如果您的图片对比源是用户头像等高度美化PS过的照片，而采集源是真实人像（比如活体检测），建议您根据score字段自行判断比对结果。PS程度越高，阈值建议设置得越低。</font>**

### 鉴权说明

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

## 请求

### 请求地址

| 名称        | 值                                                           |
| ----------- | ------------------------------------------------------------ |
| HTTP URL    | [http://verify.dun.163.com/v1/facecompare/check](http://verify.dun.163.com/v1/facecompare/check) |
| HTTP Method | POST                                                         |

### 请求头

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

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

| 名称    | 类 型  | 必填 | 最大长度                       | 描述                                                         |
| ------- | ------ | ---- | ------------------------------ | ------------------------------------------------------------ |
| avatar1 | String | 是   | URL不超过256, BASE64不超过200K | 用于人脸比对的头像照，请上传无遮挡的清晰正面照，轮廓保持完整 |
| avatar2 | String | 是   | URL不超过256, BASE64不超过200K | 用于人脸比对的头像照，请上传无遮挡的清晰正面照，轮廓保持完整 |
| picType | Number | 是   | 4                              | 图片类型：1-URL, 2-BASE64                                    |
| dataId  | String | 否   | 64                             | 数据标识，可传入用户标识等数据，便于数据查询                 |
### 请求体示例
```
avatar1=xxx&avatar2=xxx&picType=1&version=v1&businessId=xxx&timestamp=1638180222235&nonce=xxx&secretId=xxx&signature=xxx
```
## 响应
### 响应结果
响应字段如下，响应通用字段已省略，详细见[响应公共字段](https://support.dun.163.com/documents/391676076156063744?docId=624032228347863040)

| 名称      | 类型    | 必须返回 | 描述                                                         |
| --------- | ------- | -------- | ------------------------------------------------------------ |
| matched   | Integer | 是       | 比对结果，1-是同一人 2-不是同一人 3-图片下载异常|
| score     | Double  | 是       | 相似度得分，范围0-1，分数越高，相似度越高。开发者也可根据自己的认证场景依据该字段控制自己的阈值 |
| requestId | String  | 是       | 本次请求数据标识，可以根据该标识在[控制台](https://dun.163.com/dashboard#/m/idauth/data/auth/ )进行数据查询 |
| isPayed   | Number  | 是       | 本次请求是否收费标识，1代表收费，0代表不收费                 |
### 响应体示例
```json
{
	"msg": "ok",
	"result": {
		"score": 0.7102633714675903,
		"requestId": "b4c37ceb10304507b0954c27194c12ef",
		"matched": 1,
		"isPayed": 1
	},
	"code": 200
}
```
### 响应返回码
响应返回码见：[响应返回码](https://support.dun.163.com/documents/391676076156063744?docId=624032338595143680)