更新时间:2023-11-17 gmt 08:00
go sdk-凯发k8国际娱乐官网入口
本章节介绍go sdk,您可以参考本章节进行快速集成开发。
准备工作
- 注册华为帐号并开通华为云,并完成实名认证,帐号不能处于欠费或冻结状态。
- 已具备开发环境,go sdk 支持 go 1.14 及以上版本,可执行 go version 检查当前 go 的版本信息。
- 登录“ > 访问秘钥”页面,依据界面操作指引获取access key(ak)和secret access key(sk)。下载的访问秘钥为credentials.csv文件,包含ak/sk信息。
- 登录“ ”页面,获取“iam用户名”、“帐号名”以及待使用区域的“项目id”。调用服务时会用到这些信息,请提前保存。
本样例以“华北-北京四”区域为例,获取对应的项目id(project_id)。
图1 我的凭证
安装sdk
使用sdk前需要安装华为云go sdk 库。
// 安装华为云 go sdk 库 go get github.com/huaweicloud/huaweicloud-sdk-go-v3
开始使用
- 导入依赖模块
import ( "fmt" "github.com/huaweicloud/huaweicloud-sdk-go-v3/core/auth/basic" ocr "github.com/huaweicloud/huaweicloud-sdk-go-v3/services/ocr/v1" "github.com/huaweicloud/huaweicloud-sdk-go-v3/services/ocr/v1/model" region "github.com/huaweicloud/huaweicloud-sdk-go-v3/services/ocr/v1/region" )
- 配置认证信息
配置ak、sk信息。华为云通过ak识别用户的身份,通过sk对请求数据进行签名验证,用于确保请求的机密性、完整性和请求者身份的正确性。ak、sk获取方法请参见准备工作。
func main() { ak := os.getenv("huaweicloud_sdk_ak") sk := os.getenv("huaweicloud_sdk_sk") auth := basic.newcredentialsbuilder(). withak(ak). withsk(sk). build() }
- 认证用的 ak 和sk 硬编码到代码中或者明文存储都有很大的安全风险,建议在配置文件或者环境变量中密文存放,使用时解密,确保安全。
- 本示例以 ak 和 sk 保存在环境变量中来实现身份验证为例,运行本示例前请先在本地环境中设置环境变量huaweicloud_sdk_ak和huaweicloud_sdk_sk。
- 初始化客户端(二选一)
- 指定云服务region方式(推荐)
// 初始化指定云服务的客户端 new{service}client,以初始化华北-北京四(cn-north-4)区域服务为例 func main() { client := ocr.newocrclient( ocr.ocrclientbuilder(). withregion(region.valueof("cn-north-4")). withcredential(auth). build()) }
- 指定云服务endpoint方式
func main() { // 指定终端节点,以ocr服务北京四的endpoint为例 endpoint:="https://ocr.cn-north-4.myhuaweicloud.com" // 使用endpoint方式,在认证信息中需新增projectid auth := basic.newcredentialsbuilder(). withak(ak). withsk(sk). withprojectid(projectid). build() // 初始化指定云服务的客户端 new{service}client client := ocr.newocrclient( ocr.ocrclientbuilder(). withendpoint(endpoint). withcredential(auth). build()) }
endpoint是华为云各服务应用区域和各服务的终端节点,详情请查看 。
- 指定云服务region方式(推荐)
- 发送请求并查看响应
// 以调用通用表格识别接口 recognizegeneraltable 为例 request := &model.recognizegeneraltablerequest{} urlgeneraltablerequestbody:= "图片的url" request.body = &model.generaltablerequestbody{ url: &urlgeneraltablerequestbody, } response, err := client.recognizegeneraltable(request) if err == nil { fmt.printf("% v\n", response) } else { fmt.println(err) }
- 异常处理
表1 异常处理 一级分类
一级分类说明
serviceresponseerror
服务响应异常
url.error
url异常
response, err := client.recognizegeneraltable(request) if err == nil { fmt.printf("% v\n", response) } else { fmt.println(err) }
详细的sdk介绍请参见、,sdk使用方法可参考。
代码示例自动生成
提供api检索及平台调试,支持全量快速检索、可视化调试、帮助文档查看、在线咨询。
您只需要在api explorer中修改接口参数,即可自动生成对应的代码示例。同时,可在集成开发环境cloudide中完成代码的构建、调试、运行等操作。
图2 api explorer
意见反馈
文档内容是否对您有帮助?
提交成功!非常感谢您的反馈,我们会继续努力做到更好!
您可在查看反馈及问题处理状态。
系统繁忙,请稍后重试
如您有其它疑问,您也可以通过华为云社区问答频道来与我们联系探讨