腾讯云人脸核身服务端 API 调用指南（Python、Java、Go）

from tencentcloud.common import credential
from tencentcloud.common.profile.client_profile import ClientProfile
from tencentcloud.common.profile.http_profile import HttpProfile
from tencentcloud.faceid.v20180301 import faceid_client, models

# 初始化认证信息
cred = credential.Credential("YourSecretId", "YourSecretKey")

http_profile = HttpProfile()
http_profile.endpoint = "faceid.tencentcloudapi.com"

client_profile = ClientProfile()
client_profile.httpProfile = http_profile

client = faceid_client.FaceidClient(cred, "ap-guangzhou", client_profile)

# 步骤1：获取核身 Token
req = models.GetFaceIdTokenRequest()
resp = client.GetFaceIdToken(req)
print(resp.to_json_string())

# 步骤2：用户完成核身后，获取核身结果
result_req = models.GetFaceIdResultRequest()
result_req.FaceIdToken = "上一步返回的FaceIdToken"
result_resp = client.GetFaceIdResult(result_req)
print(result_resp.to_json_string())

import com.tencentcloudapi.common.Credential;
import com.tencentcloudapi.common.profile.ClientProfile;
import com.tencentcloudapi.common.profile.HttpProfile;
import com.tencentcloudapi.faceid.v20180301.FaceidClient;
import com.tencentcloudapi.faceid.v20180301.models.GetFaceIdTokenRequest;
import com.tencentcloudapi.faceid.v20180301.models.GetFaceIdTokenResponse;
import com.tencentcloudapi.faceid.v20180301.models.GetFaceIdResultRequest;
import com.tencentcloudapi.faceid.v20180301.models.GetFaceIdResultResponse;

public class FaceIdServerDemo {
    private static final String SECRET_ID = "YourSecretId";
    private static final String SECRET_KEY = "YourSecretKey";
    private static final String REGION = "ap-guangzhou";

    public static void main(String[] args) throws Exception {
        // 初始化认证信息
        Credential cred = new Credential(SECRET_ID, SECRET_KEY);

        HttpProfile httpProfile = new HttpProfile();
        httpProfile.setEndpoint("faceid.tencentcloudapi.com");

        ClientProfile clientProfile = new ClientProfile();
        clientProfile.setHttpProfile(httpProfile);

        FaceidClient client = new FaceidClient(cred, REGION, clientProfile);

        // 步骤1：获取核身 Token
        GetFaceIdTokenRequest tokenReq = new GetFaceIdTokenRequest();
        GetFaceIdTokenResponse tokenResp = client.GetFaceIdToken(tokenReq);
        System.out.println(GetFaceIdTokenResponse.toJsonString(tokenResp));

        // 步骤2：用户完成核身后，获取核身结果
        GetFaceIdResultRequest resultReq = new GetFaceIdResultRequest();
        resultReq.setFaceIdToken("上一步返回的FaceIdToken");
        GetFaceIdResultResponse resultResp = client.GetFaceIdResult(resultReq);
        System.out.println(GetFaceIdResultResponse.toJsonString(resultResp));
    }
}

<dependency>
    <groupId>com.tencentcloudapi</groupId>
    <artifactId>tencentcloud-sdk-java-faceid</artifactId>
    <version>3.1.xxx</version>
</dependency>

package main

import (
    "encoding/json"
    "log"
    "net/http"

    "github.com/tencentcloud/tencentcloud-sdk-go/tencentcloud/common"
    "github.com/tencentcloud/tencentcloud-sdk-go/tencentcloud/common/profile"
    "github.com/tencentcloud/tencentcloud-sdk-go/tencentcloud/faceid/v20180301"
)

var FaceIdClient *faceid.Client

func init() {
    // 初始化客户端配置对象，您可以指定超时时间和其他配置项
    prof := profile.NewClientProfile()
    prof.HttpProfile.ReqTimeout = 60
    // TODO 需要替换成您调用账号的 SecretId 和 SecretKey
    credential := common.NewCredential("SecretId", "SecretKey")
    var err error
    // 初始化调用慧眼人脸核身服务的客户端
    FaceIdClient, err = faceid.NewClient(credential, "ap-guangzhou", prof)
    if nil != err {
        log.Fatal("FaceIdClient init error: ", err)
    }
}

// GetFaceIdToken 获取人脸核身 Token
func GetFaceIdTokenHandler(w http.ResponseWriter, r *http.Request) {
    log.Println("get face id token")
    // 步骤1: 解析请求参数
    _ = r.ParseForm()
    compareLib := r.FormValue("CompareLib")

    // 步骤2: 初始化请求对象，并给必要的参数赋值
    request := faceid.NewGetFaceIdTokenRequest()
    request.CompareLib = &compareLib

    // 步骤3: 通过 FaceIdClient 调用人脸核身服务
    response, err := FaceIdClient.GetFaceIdToken(request)
    if nil != err {
        _, _ = w.Write([]byte("error"))
        return
    }

    // 步骤4: 处理腾讯云 API 的响应，并构造返回对象
    faceIdToken := response.Response.FaceIdToken
    apiResp := struct {
        FaceIdToken *string
    }{FaceIdToken: faceIdToken}
    b, _ := json.Marshal(apiResp)

    // 步骤5: 返回服务响应
    _, _ = w.Write(b)
}

// GetFaceIdResult 获取人脸核身核验结果
func GetFaceIdResultHandler(w http.ResponseWriter, r *http.Request) {
    // 步骤1: 解析请求参数
    _ = r.ParseForm()
    faceIdToken := r.FormValue("FaceIdToken")

    // 步骤2: 初始化请求对象，并给必要的参数赋值
    request := faceid.NewGetFaceIdResultRequest()
    request.FaceIdToken = &faceIdToken

    // 步骤3: 通过 FaceIdClient 调用人脸核身服务
    response, err := FaceIdClient.GetFaceIdResult(request)
    if nil != err {
        _, _ = w.Write([]byte("error"))
        return
    }

    // 步骤4: 处理腾讯云 API 的响应，并构造返回对象
    result := response.Response.Result
    apiResp := struct {
        Result *string
    }{Result: result}
    b, _ := json.Marshal(apiResp)

    // 步骤5: 返回服务响应
    _, _ = w.Write(b)
}

func main() {
    // 注册 HTTP 接口路径
    http.HandleFunc("/api/v1/get-token", GetFaceIdTokenHandler)
    http.HandleFunc("/api/v1/get-result", GetFaceIdResultHandler)
    // 监听端口
    err := http.ListenAndServe(":8080", nil)
    if nil != err {
        log.Fatal("Server error: ", err)
    }
}

go get github.com/tencentcloud/tencentcloud-sdk-go/tencentcloud/faceid/v20180301