1. 概述
本文详细介绍E证通微信小程序服务端集成流程,请您确保在阅读本文前已阅读 接入流程说明 并按照步骤执行。阅读完本文您可以轻松将您的服务端与腾讯云E证通小程序服务端连通。为了让您调用 API 更简单,腾讯云 API 3.0提供了多种编程语言的 SDK 供您选择,您可以选择您熟悉的语言进行编码,本文将使用Java 语言作为示例演示如何使用腾讯云 SDK 调用E证通微信小程序服务端接口。
2. 集成准备
2.1 获取密钥
2.2 获取SDK
3. 接口说明
E 证通小程序服务端集成主要包含两个接口:GetEidToken 和 GetEidResult。每次调用E证通服务前,需先调用 GetEidToken 接口获取EidToken,用来串联E证通核身认证流程,在验证完成后,通过调用 GetEidResult 接口获取认证结果信息。在服务端集成接口前,您也可以通过腾讯云提供的 在线调试 功能查看每次调用的请求内容和返回结果以及自动生成 SDK 调用示例。详细的接口调用可以参考以下调用示例。
4. Example
4.1 获取EidToken
package com.tencent;import com.tencentcloudapi.common.Credential;import com.tencentcloudapi.common.exception.TencentCloudSDKException;import com.tencentcloudapi.faceid.v20180301.FaceidClient;import com.tencentcloudapi.faceid.v20180301.models.GetEidTokenConfig;import com.tencentcloudapi.faceid.v20180301.models.GetEidTokenRequest;import com.tencentcloudapi.faceid.v20180301.models.GetEidTokenResponse;public class GetEidToken {private static final String SECRET_ID = ""; // TODO 您账号的腾讯云密钥private static final String SECRET_KEY = ""; // TODO 您账号的腾讯云密钥private static final String REGION = "ap-guangzhou";public static void main(String[] args) {// Step 1. 初始化客户端实例Credential credential = new Credential(SECRET_ID, SECRET_KEY);FaceidClient faceidClient = new FaceidClient(credential, REGION);// Step 2. 使用Tencent Cloud API SDK组装请求体,填充参数// 详细的接口文档请参考:https://cloud.tencent.com/document/product/1007/54089GetEidTokenRequest request = new GetEidTokenRequest();request.setMerchantId(""); // 商户ID,请在控制台查看已经申请的商户IDGetEidTokenConfig config = new GetEidTokenConfig();config.setInputType("3"); // 指定姓名和身份证号输入方式request.setConfig(config);try {// Step 3. 调用接口GetEidTokenResponse response = faceidClient.GetEidToken(request);System.out.println("SDK response: " + GetEidTokenResponse.toJsonString(response));} catch (TencentCloudSDKException e) {// 调用接口异常在这里处理System.err.println("invoke error, code: " + e.getErrorCode() + "message: " + e.getMessage());e.printStackTrace();}}}
4.2 查询E证通核身结果
package com.tencent;import com.tencentcloudapi.common.Credential;import com.tencentcloudapi.common.exception.TencentCloudSDKException;import com.tencentcloudapi.faceid.v20180301.FaceidClient;import com.tencentcloudapi.faceid.v20180301.models.GetEidResultRequest;import com.tencentcloudapi.faceid.v20180301.models.GetEidResultResponse;public class GetEidResult {private static final String SECRET_ID = ""; // TODO 您账号的腾讯云密钥private static final String SECRET_KEY = ""; // TODO 您账号的腾讯云密钥private static final String REGION = "ap-guangzhou";public static void main(String[] args) {// Step 1. 初始化客户端实例Credential credential = new Credential(SECRET_ID, SECRET_KEY);FaceidClient faceidClient = new FaceidClient(credential, REGION);// Step 2. 使用Tencent Cloud API SDK组装请求体,填充参数// 详细的接口文档请参考:https://cloud.tencent.com/document/product/1007/54090GetEidResultRequest request = new GetEidResultRequest();request.setEidToken(""); // 通过GetEidResult接口获取到的EidTokenrequest.setInfoType("0"); // 指定拉取的结果信息try {// Step 3. 调用接口GetEidResultResponse response = faceidClient.GetEidResult(request);System.out.println("SDK response: " + GetEidResultResponse.toJsonString(response));} catch (TencentCloudSDKException e) {// 调用接口异常在这里处理System.err.println("invoke error, code: " + e.getErrorCode() + "message: " + e.getMessage());e.printStackTrace();}}}
5. 错误码列表