前言

在工作中遇到需要验证姓名跟身份证号码是否匹配,使用腾讯云的身份信息认证即可完成

接口描述

接口请求域名： faceid.tencentcloudapi.com 。
传入姓名和身份证号，校验两者的真实性和一致性。

输入参数

其他所需要的数据还有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;
    }