腾讯云身份信息核验

迷南。 2023-09-27 23:04 173阅读 0赞

## 前言 ##

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

### 接口描述 ###

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

### 输入参数 ###

<table> 
 <thead> 
  <tr> 
   <th>参数名称</th> 
   <th>类型</th> 
   <th>描述</th> 
  </tr> 
 </thead> 
 <tbody> 
  <tr> 
   <td>IdCard</td> 
   <td>String</td> 
   <td>身份证号</td> 
  </tr> 
  <tr> 
   <td>Name</td> 
   <td>String</td> 
   <td>姓名</td> 
  </tr> 
 </tbody> 
</table>

其他所需要的数据还有SecretId和SecretKey,具体获取方式可前往官网控制台 [https://console.cloud.tencent.com/cam/capi][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;
        }

[https_console.cloud.tencent.com_cam_capi]: https://console.cloud.tencent.com/cam/capi