1. 接口描述

在核验用户身份信息的同时、确保当前操作人为本人。可应用于远程开户、在线教育、刷脸支付等场景。通过用户的身份证号、姓名和自拍照去第三方进行身份验证，通过返回分数判断是否为同一个人。

2. 使用场景

酒店、机场、高铁、火车站这种人流聚集地，用于安保防范。

物流行业会要求对司机/货主进行身份核验。确保运输安全。

游戏、直播平台需要进行身份核验，用于防沉迷系统等。

金融保险行业也需要进行身份核验，用于风控场景，减少欺诈行为。

疫情防控，大家做核酸，出示健康码的时候都需要进行身份核验。

3. 接口说明

3.1. 发起请求

入参：姓名+身份证号+人脸照出参：1-认证一致02-认证不一致03-库无04-认证失败

3.1.1. 接口协议

HTTP  POST

3.1.2. 接口方法

https://api.juncyun.com/api/identityVerify/photomatch

3.1.3. 报头定义

 

编码	列表	内容	备注
1）	Accept	application/json
2）	Content-Type	application/json;charset=utf-8

 

3.1.4. 请求参数

3.1.4.1. 请求参数列表

 

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

 

 

3.1.4.2. 请求参数示例

{

"accessKey": "NDYw*******",

"accessSecret": "MDQyOTQ1OTM3*********************",

"idNo":"341225****",

"name":"李明",

"image":"DAQL/xAA+EAACAgEEAAUCAwYD***************"

}

 

3.1.5. 响应参数

3.1.5.1. 响应参数列表

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

  

3.1.5.2. 响应成功参数示例

{

"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"

}

}

 

3.1.5.3.结果码说明

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