前言
在工作中遇到需要验证姓名跟身份证号码是否匹配,使用腾讯云的身份信息认证即可完成
接口描述
接口请求域名: faceid.tencentcloudapi.com 。
传入姓名和身份证号,校验两者的真实性和一致性。
输入参数
参数名称 | 类型 | 描述 |
---|---|---|
IdCard | String | 身份证号 |
Name | String | 姓名 |
其他所需要的数据还有SecretId和SecretKey,具体获取方式可前往官网控制台 https://console.cloud.tencent.com/cam/capi 进行获取
输出参数
1.Result:认证结果码,收费情况如下。收费结果码:
0: 姓名和身份证号一致
-1: 姓名和身份证号不一致
不收费结果码:
-2: 非法身份证号(长度、校验位等不正确)
-3: 非法姓名(长度、格式等不正确)
-4: 证件库服务异常
-5: 证件库中无此身份证记录
-6: 权威比对系统升级中,请稍后再试
-7: 认证次数超过当日限制
2.Description:业务结果描述。
3.RequestId:唯一请求 ID,每次请求都会返回。定位问题时需要提供该次请求的 RequestId。
代码
public IdCardVerificationResponse checkIdentityInfo(IdentityInfoDto identityInfoDto) {
IdCardVerificationResponse resp = new IdCardVerificationResponse();
try {
if (StringUtils.isBlank(identityInfoDto.getName()) || StringUtils.isBlank(identityInfoDto.getIdCard())) {
throw new BusinessException("请输入姓名与身份证信息!");
}
// 实例化一个认证对象,入参需要传入腾讯云账户 SecretId 和 SecretKey,此处还需注意密钥对的保密
// 代码泄露可能会导致 SecretId 和 SecretKey 泄露,并威胁账号下所有资源的安全性。以下代码示例仅供参考,建议采用更安全的方式来使用密钥,请参见:https://cloud.tencent.com/document/product/1278/85305
// 密钥可前往官网控制台 https://console.cloud.tencent.com/cam/capi 进行获取
Credential cred = new Credential(getSecretId(), getSecretKey());
// 实例化一个http选项,可选的,没有特殊需求可以跳过
HttpProfile httpProfile = new HttpProfile();
httpProfile.setEndpoint("faceid.tencentcloudapi.com");
// 实例化一个client选项,可选的,没有特殊需求可以跳过
ClientProfile clientProfile = new ClientProfile();
clientProfile.setHttpProfile(httpProfile);
// 实例化要请求产品的client对象,clientProfile是可选的
FaceidClient client = new FaceidClient(cred, "", clientProfile);
// 实例化一个请求对象,每个接口都会对应一个request对象
IdCardVerificationRequest req = new IdCardVerificationRequest();
req.setIdCard(identityInfoDto.getIdCard());
req.setName(identityInfoDto.getName());
// 返回的resp是一个IdCardVerificationResponse的实例,与请求对象对应
resp = client.IdCardVerification(req);
// 输出json格式的字符串回包
System.out.println(IdCardVerificationResponse.toJsonString(resp));
} catch (TencentCloudSDKException e) {
System.out.println(e.toString());
}
return resp;
}