人脸匹配
1. 描述
将两个人脸进行比对，来判断是否为同一个人，返回相似度分值和人物颜值
注：人脸匹配时会自动对所有过滤集合内数据进行搜索，如果命中敏感人物，会返回服务错误码10005及业务错误码10015
2. URL
https://cosmos-cv-api.immomo.com/matchOne
3. 请求方式
POST
4. 参数
| 名称 | 类型 | 是否必传 | 说明 | 示例 |
|---|---|---|---|---|
| timestamp | int | true | 当前时间戳（秒） | 1522222222 |
| sign | string | true | 签名，生成算法 md5 (appid + appkey + timestamp) | |
| appId | string | true | 业务方appId | |
| type | int | true | 查询方式 1-url， 2-feature，3-图片二进制文件 | |
| personId | string | true | 人脸ID | |
| imgUrl | string | false | 图片url | |
| imgMsg | string | false | 人脸特征数据 | |
| image | file | false | 图片二进制文件 | 图片 |
5. 返回数据
{
"code": 10000,
"message": "操作成功",
"data": {
"score": 0.6, // 相似度值 0 ~ 1.0
"beautyScore": 90.0, // 颜值 0 ~ 100
"qualityCode": 51, // 人脸质量
"ec": 10011
}
}
6. 服务错误码（code）
| 码值 | 含义 |
|---|---|
| 10000 | 操作成功 |
| 10001 | 服务错误 |
| 10002 | 参数错误 |
| 10003 | appId校验失败 |
| 10005 | 命中过滤集合 |
7. 业务错误码（ec）
| 码值 | 含义 |
|---|---|
| 10011 | URL错误 |
| 10012 | personId不存在 |
| 10015 | 命中过滤集合 |