人像比对接口文档

---

1.接口说明

名称	说明
协议	HTTPS POST
地址	https://api.cxlnk.com/api/identityVerify/photomatch
Accept	application/json
Content-Type	application/json;charset=utf-8

2.请求参数说明

响应 body 数据为 JSON 格式

列表	内容	备注
accessKey	API调用账号（必填，String类型，从灿星云平台获取）
accessSecret	API调用密钥（必填，String类型，从灿星云平台获取）
idNo	身份证号码（必填）
name	姓名（必填）
image	人脸照，base64字符串，图片大小不能大于32K（必填）	base64字符串去掉头部描述(如data:image/png;base64)

3.请求参数示例

{
 "accessKey": "NDYw*******",
 "accessSecret": "MDQyOTQ1OTM3*********************",
 "idNo":"341225****",
 "name":"李明",
 "image":"DAQL/xAA+EAACAgEEAAUCAwYD***************"
}
					

4.响应参数列表

列表	内容	备注
code	状态码200则为成功
msg	状态说明
success	处理是否成功:取值范围 true，false
data	业务数据 如果失败则为空
orderNo	流水号
handleTime	查询时间
result	返回结果，01--一致02--不一致03--库无04--认证失败（该字段不作为最终结果，具体核验结果请参考"idcardResult"、"photoResult"）
idcardResult	身份证核验结果01--一致02--不一致03--库无04--认证失败
idcardMessage	身份证核验结果说明
photoResult	图像结果01--判断为同一人02--判断不是同一人03--不能确定是否为同一人04--认证失败05--身份校验未通过06--库中无照片07--图片质量不合格,详情请联系管理员08--库中无此号09-无法验证
photoMessage	图像结果说明
photoScore	照片相似的分数(0-100)，查询中心分值：中心的人像我司提供的建议范围为0-40分为不同人，40-60分为不确定，60-100为同一人。注：可以根据自己的使用场景对错误率的敏感度，通过返回的相似度得分，自行调整置信区间，已达到合适的判断效果
fee	是否扣费：0不收费，1收费

5.响应参数示例

{
 "code": 200,
 "msg": "成功",
 "success": true,
 "data": { 
          "orderNo":"021733******",
		  "handleTime":"2024-01-1009:33:59",
		  "result":"01",
		  "idcardResult":"01",
		  "idcardMessage":"一致",
		  "photoResult":"01",
		  "photoMessage":"判断为同一人",
		  "photoScore":"88",
		  "fee":"1"
    }
}
						

6.结果码说明

结果码	描述
200	成功
500，501，503	系统错误
502	系统繁忙
60021	余额不足，请充值后重试！
10000	内部系统出错，请联系厂商