登录

文档中心

文档目录

人像比对

最近更新时间: 2024-01-24 15:13:22

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 内部系统出错,请联系厂商

人像比对

最近更新时间: 2024-01-24 15:13:22

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 内部系统出错,请联系厂商
加微咨询

一对一服务,更有优惠惊喜