人证核身服务 IVS-Go SDK:开始使用SDK

时间：2024-11-04 16:58:02

人证核身服务 IVS

开始使用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)
}

上一篇：人证核身服务 IVS-Go SDK:SDK demo代码解析

下一篇：人证核身服务 IVS-Go SDK:SDK demo代码解析