Go SDK

最近更新时间:2022-10-13 18:13:58

我的收藏

简介

欢迎使用 TBaaS 产品开发者工具套件(SDK)3.0,SDK3.0 是云 API3.0 平台的配套工具。为方便 Go 开发者调试和接入 TBaaS 产品 API,这里向您介绍适用于 Go 的 TBaaS 产品开发工具包,并提供首次使用开发工具包的简单示例。让您快速获取 TBaaS 产品 Go SDK 并开始调用。

依赖环境

1. 依赖环境:Go 1.9版本及以上,并设置好 GOPATH 等必须的环境变量。
2. 通过腾讯云控制台开通 TBaaS 产品。
3. 获取 SecretID、SecretKey 以及调用地址(tbaas.tencentcloudapi.com)。

获取安装

安装 Go SDK 和第一次使用云 API 之前,用户需要在腾讯云控制台上申请并获取安全凭证。安全凭证包括 SecretID 和 SecretKey。SecretID 用于标识 API 调用者的身份,SecretKey 用于加密签名字符串和服务器端验证签名字符串的密钥。SecretKey 必须严格保管,避免泄露。

通过 go get 安装(推荐)

使用语言自带的工具安装 SDK:
go get -u github.com/tencentcloud/tencentcloud-sdk-go

通过源码包安装

1. 前往 Github 代码托管地址 下载最新代码。
2. 将获取到的源码包解压缩,并安装到 $GOPATH/src/github.com/tencentcloud 目录下。

接口列表

详细的接口列表请查看 API文档

示例

以新增交易(Invoke)接口为例:
package main
import (
"fmt"
"github.com/tencentcloud/tencentcloud-sdk-go/tencentcloud/common"
"github.com/tencentcloud/tencentcloud-sdk-go/tencentcloud/common/errors"
"github.com/tencentcloud/tencentcloud-sdk-go/tencentcloud/common/profile"
tbaas "github.com/tencentcloud/tencentcloud-sdk-go/tencentcloud/tbaas/v20180416"
)

func main() {
// 必要步骤:
// 实例化一个认证对象,入参需要传入腾讯云账户密钥对secretId,secretKey。
credential := common.NewCredential("secretId", "secretKey")
// 实例化一个客户端配置对象,可以指定超时时间等配置
cpf := profile.NewClientProfile()
// SDK有默认的超时时间,非必要请不要进行调整。
// 如有需要请在代码中查阅以获取最新的默认值。
cpf.HttpProfile.ReqTimeout = 10
// 设置访问域名
// SDK会自动指定域名。通常是不需要特地指定域名的,但是如果您访问的是金融区的服务,
// 则必须手动指定域名,例如云服务器的上海金融区域名: tbaas.ap-shanghai-fsi.tencentcloudapi.com
cpf.HttpProfile.Endpoint = "tbaas.tencentcloudapi.com"
// 实例化Tbaas的client对象
// 第二个参数是地域信息,根据资源所属地域填写相应的地域信息,例如广州地域的资源可以直接填写字符串ap-guangzhou,或者引用预设的常量
client, _ := tbaas.NewClient(credential, regions.Guangzhou, cpf)
// 实例化一个请求对象,根据调用的接口和实际情况,可以进一步设置请求参数
request := tbaas.NewInvokeRequest()
params := "{\\"Module\\":\\"transaction\\",\\"Operation\\":\\"invoke\\",\\"ClusterId\\":\\"251005746ctestenv\\",\\"ChaincodeName\\":\\"pettycc1\\",\\"ChannelName\\":\\"pettyc1\\",\\"Peers\\":[{\\"PeerName\\":\\"peer0.pettycorg.ctestenv\\",\\"OrgName\\":\\"pettycOrg\\"}],\\"FuncName\\":\\"invoke\\",\\"Args\\":[\\"a\\",\\"b\\",\\"10\\"],\\"AsyncFlag\\":0,\\"GroupName\\":\\"pettycOrg\\"}"
err := request.FromJsonString(params)
if err != nil {
panic(err)
}
// 通过client对象调用想要访问的接口,需要传入请求对象
response, err := client.Invoke(request)
// 处理异常
if _, ok := err.(*errors.TencentCloudSDKError); ok {
fmt.Printf("An API error has returned: %s", err)
return
}
// 非SDK异常,直接失败。实际代码中可以加入其他的处理。
if err != nil {
panic(err)
}
// 打印返回的json字符串
fmt.Printf("%s", response.ToJsonString())
}