文档首页/ 人证核身服务 IVS/ SDK参考/ Go SDK

更新时间：2024-11-04 GMT+08:00

Go SDK

本章节介绍人证核身服务Go SDK，您可以参考本章节进行快速集成开发。

准备工作

注册华为账号并开通华为云，并完成实名认证，账号不能处于欠费或冻结状态。
已开通人证核身服务。如未开通，请登录人证核身管理控制台开通所需服务。
已具备开发环境，Go SDK 支持 go 1.14 及以上版本，可执行 go version 检查当前 Go 的版本信息。
登录“我的凭证 > 访问秘钥”页面，获取Access Key（AK）和Secret Access Key（SK）。
图1 获取AK、SK
登录“我的凭证”页面，获取“IAM用户名”“、账号名”以及待使用区域的“项目ID”。调用服务时会用到这些信息，请提前保存。
本样例以“华北-北京四”区域为例，获取对应的项目ID（project_id）。

图2 我的凭证

安装SDK

使用SDK前需要安装华为云Go SDK 库。

# 安装华为云Go库
go get -u github.com/huaweicloud/huaweicloud-sdk-go-v3
# 安装依赖
go get github.com/json-iterator/go

开始使用SDK

导入依赖模块

import (
	"fmt"
        "os"
	"github.com/huaweicloud/huaweicloud-sdk-go-v3/core/auth/basic"
    // 导入IVS sdk
	ivs "github.com/huaweicloud/huaweicloud-sdk-go-v3/services/ivs/v2"
	"github.com/huaweicloud/huaweicloud-sdk-go-v3/services/ivs/v2/model"
	"github.com/huaweicloud/huaweicloud-sdk-go-v3/services/ivs/v2/region"
)

配置认证信息
 配置AK、SK信息。华为云通过AK识别用户的身份，通过SK对请求数据进行签名验证，用于确保请求的机密性、完整性和请求者身份的正确性。AK、SK获取方法请参见准备工作。
```
// 创建AK、SK认证凭据
func GetCredential(ak, sk string) basic.Credentials {
	return basic.NewCredentialsBuilder().
		WithAk(ak).
		WithSk(sk).
		Build()
}
```
初始化认证信息：
```
ak := os.Getenv("HUAWEICLOUD_SDK_AK")
sk := os.Getenv("HUAWEICLOUD_SDK_SK")
client := GetCredential(ak, sk)
```
- 认证用的 ak 和sk 硬编码到代码中或者明文存储都有很大的安全风险，建议在配置文件或者环境变量中密文存放，使用时解密，确保安全。
- 本示例以 ak 和 sk 保存在环境变量中来实现身份验证为例，运行本示例前请先在本地环境中设置环境变量HUAWEICLOUD_SDK_AK和HUAWEICLOUD_SDK_SK。
图3 Windows环境新建环境变量

初始化客户端

指定region方式

// 选择服务部署区域
func GetClient(auth basic.Credentials) *ivs.IvsClient {
	return ivs.NewIvsClient(
		ivs.IvsClientBuilder().
			WithRegion(region.CN_NORTH_4).
			WithCredential(auth).
			Build())
}

CN_NORTH_4：华北-北京四

CN_NORTH_1：华北-北京一

发送请求并查看响应

# 以调用标准版(三要素)接口 DetectStandardByIdCardImage 为例
request := &model.DetectStandardByIdCardImageRequest{}
response, err := client.DetectStandardByIdCardImage(request)
if err == nil {
    fmt.Printf("%+v\n", response)
} else {
    fmt.Println(err)
}

异常处理

表1 异常处理
一级分类	一级分类说明
ServiceResponseError	服务响应异常
url.Error	url异常

// 异常处理
response, err := client.DetectStandardByIdCardImage(request)
if err == nil {
    fmt.Printf("%+v\n", response)
} else {
    fmt.Println(err)
}

详细的SDK介绍请参见SDK中心、Go SDK使用指导、Go SDK使用视频。

SDK demo代码解析

人证核身标准版（三要素）

方式一：使用身份证图片、人像图片进行校验

request := &model.DetectStandardByIdCardImageRequest{}
idcardImage2ReqDataReqDataByIdCardImage:= "身份证国徽面图像数据,使用base64编码"
var listReqDataIvsStandardByIdCardImageRequestBodyData = []model.ReqDataByIdCardImage{
    {
        IdcardImage1: "身份证人像面图像数据,使用base64编码",
        IdcardImage2: &idcardImage2ReqDataReqDataByIdCardImage,
        FaceImage: "现场人像图像数据,使用base64编码,",
    },
}
databody := &model.IvsStandardByIdCardImageRequestBodyData{
	ReqData: &listReqDataIvsStandardByIdCardImageRequestBodyData,
}
uuidMetaMeta:= "唯一标识此次请求的ID,用户自定义,不超过64位。例如10eb0091-887f-4839-9929-cbc884f1e20e"
metabody := &model.Meta{
	Uuid: &uuidMetaMeta,
}
request.Body = &model.IvsStandardByIdCardImageRequestBody{
	Data: databody,
	Meta: metabody,
}
response, err := client.DetectStandardByIdCardImage(request)
if err == nil {
    fmt.Printf("%+v\n", response)
} else {
    fmt.Println(err)
}

方式二：使用身份证姓名、身份证号码文本，人像图片进行校验

request := &model.DetectStandardByNameAndIdRequest{}
var listReqDataIvsStandardByNameAndIdRequestBodyData = []model.StandardReqDataByNameAndId{
    {
        VerificationName: "被验证人的姓名",
        VerificationId: "被验证人的身份证号码",
        FaceImage: "现场人像图像数据,使用base64编码",
    },
}
databody := &model.IvsStandardByNameAndIdRequestBodyData{
	ReqData: &listReqDataIvsStandardByNameAndIdRequestBodyData,
}
uuidMetaMeta:= "唯一标识此次请求的ID,用户自定义,不超过64位。例如10eb0091-887f-4839-9929-cbc884f1e20e"
metabody := &model.Meta{
	Uuid: &uuidMetaMeta,
}
request.Body = &model.IvsStandardByNameAndIdRequestBody{
	Data: databody,
	Meta: metabody,
}
response, err := client.DetectStandardByNameAndId(request)
if err == nil {
    fmt.Printf("%+v\n", response)
} else {
    fmt.Println(err)
}

方式三：使用身份证姓名、身份证号码文本和现场拍摄的人像视频数据，实现活体人证核身

request := &model.DetectStandardByVideoAndNameAndIdRequest{}
var listReqDataData = []model.StandardReqDataByVideoAndNameAndId{
	{
		VerificationName: "被验证人的姓名",
		VerificationId:   "被验证人的身份证号码",
		Video:            "现场拍摄人像视频数据,使用base64编码",
		Actions:          "动作代码顺序列表",
	},
}
databody := &model.IvsStandardByVideoAndNameAndIdRequestBodyData{
	ReqData: &listReqDataData,
}
uuidMeta := "唯一标识此次请求的ID,用户自定义,不超过64位。例如10eb0091-887f-4839-9929-cbc884f1e20e"
metabody := &model.Meta{
	Uuid: &uuidMeta,
}
request.Body = &model.IvsStandardByVideoAndNameAndIdRequestBody{
	Data: databody,
	Meta: metabody,
}
response, err := client.DetectStandardByVideoAndNameAndId(request)
if err == nil {
	fmt.Printf("%+v\n", response)
} else {
	fmt.Println(err)
}

方式四：使用现场拍摄的人像视频数据，实现活体人证核身

request := &model.DetectStandardByVideoAndIdCardImageRequest{}
idcardImage2ReqData:= "身份证国徽面图像数据,使用base64编码"
var listReqDataData = []model.ReqDataByVideoAndIdCardImage{
    {
        IdcardImage1: "身份证人像面图像数据,使用base64编码",
        IdcardImage2: &idcardImage2ReqData,
        Video: "现场拍摄人像视频数据,使用base64编码",
        Actions: "动作代码顺序列表",
    },
}
databody := &model.IvsStandardByVideoAndIdCardImageRequestBodyData{
	ReqData: &listReqDataData,
}
uuidMeta:= "唯一标识此次请求的ID,用户自定义,不超过64位。例如10eb0091-887f-4839-9929-cbc884f1e20e"
metabody := &model.Meta{
	Uuid: &uuidMeta,
}
request.Body = &model.IvsStandardByVideoAndIdCardImageRequestBody{
	Data: databody,
	Meta: metabody,
}
response, err := client.DetectStandardByVideoAndIdCardImage(request)
if err == nil {
    fmt.Printf("%+v\n", response)
} else {
    fmt.Println(err)
}

人证核身证件版（二要素）

方式一：使用身份证图片进行校验

request := &model.DetectExtentionByIdCardImageRequest{}
idcardImage2ReqDataExtentionReqDataByIdCardImage:= "身份证国徽面图像数据,使用base64编码"
var listReqDataIvsExtentionByIdCardImageRequestBodyData = []model.ExtentionReqDataByIdCardImage{
    {
        IdcardImage1: "身份证人像面图像数据,使用base64编码",
        IdcardImage2: &idcardImage2ReqDataExtentionReqDataByIdCardImage,
    },
}
databody := &model.IvsExtentionByIdCardImageRequestBodyData{
	ReqData: &listReqDataIvsExtentionByIdCardImageRequestBodyData,
}
uuidMetaMeta:= "唯一标识此次请求的ID,用户自定义,不超过64位。例如10eb0091-887f-4839-9929-cbc884f1e20e"
metabody := &model.Meta{
	Uuid: &uuidMetaMeta,
}
request.Body = &model.IvsExtentionByIdCardImageRequestBody{
	Data: databody,
	Meta: metabody,
}
response, err := client.DetectExtentionByIdCardImage(request)
if err == nil {
    fmt.Printf("%+v\n", response)
} else {
    fmt.Println(err)
}

方式二：使用身份证姓名、身份证号码文本进行校验

request := &model.DetectExtentionByNameAndIdRequest{}
var listReqDataIvsExtentionByNameAndIdRequestBodyData = []model.ExtentionReqDataByNameAndId{
    {
        VerificationName: "被验证人的姓名",
        VerificationId: "被验证人的身份证号码",
    },
}
databody := &model.IvsExtentionByNameAndIdRequestBodyData{
	ReqData: &listReqDataIvsExtentionByNameAndIdRequestBodyData,
}
uuidMetaMeta:= "唯一标识此次请求的ID,用户自定义,不超过64位。例如10eb0091-887f-4839-9929-cbc884f1e20e"
metabody := &model.Meta{
	Uuid: &uuidMetaMeta,
}
request.Body = &model.IvsExtentionByNameAndIdRequestBody{
	Data: databody,
	Meta: metabody,
}
response, err := client.DetectExtentionByNameAndId(request)
if err == nil {
    fmt.Printf("%+v\n", response)
} else {
    fmt.Println(err)
}

代码示例自动生成

API Explorer提供API检索及平台调试，支持全量快速检索、可视化调试、帮助文档查看和在线咨询。

您只需要在API Explorer中修改接口参数，即可自动生成对应的代码示例。同时，可在集成开发环境CloudIDE中完成代码的构建、调试和运行等操作。

图4 API Explorer
点击放大

上一篇：Python SDK

下一篇：.NET SDK

意见反馈

文档内容是否对您有帮助？

有帮助没帮助

提供反馈

提交成功！非常感谢您的反馈，我们会继续努力做到更好！您可在我的云声建议查看反馈及问题处理状态。

系统繁忙，请稍后重试

在使用文档中是否遇到以下问题

内容与产品页面不一致

内容不易理解

缺失示例代码

步骤不可操作

搜不到想要的内容

缺少最佳实践

意见反馈（选填）

0/500

请至少选择一项反馈信息并填写问题反馈

字符长度不能超过500

直接提交取消

如您有其它疑问，您也可以通过华为云社区问答频道来与我们联系探讨

智能客服提问云社区提问

Go SDK

准备工作

安装SDK

开始使用SDK

SDK demo代码解析

代码示例自动生成

相关文档

意见反馈

文档内容是否对您有帮助？

7*24

备案

专业服务

退订

建议反馈

售前咨询热线