腾讯云区块链服务平台 TBaaS Go SDK-开发指南-文档中心-腾讯云

简介
欢迎使用 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())
}
﻿
﻿
﻿
Go SDK

本页目录：

简介

依赖环境

获取安装

通过 go get 安装（推荐）

通过源码包安装

接口列表

示例
