Go 快速开始
了解如何安装和配置Lybic Go SDK。
本指南将带您完成Lybic Go SDK的安装与配置过程,帮您使用Go快速接入Lybic。
安装
首先,将 Lybic Go SDK 作为依赖项添加到您的项目中。
go get github.com/lybic/lybic-sdk-go初始化和配置
在您的 Go 应用程序中初始化客户端。您可以将 nil 传递给 NewClient 函数,从环境变量配置客户端;也可以自行创建 lybic.Config 结构体进行编程配置。
基本初始化
此示例使用环境变量初始化客户端。
package main
import (
"context"
"fmt"
"github.com/lybic/lybic-sdk-go"
)
func main() {
// 传递 nil 会使用环境变量初始化客户端
client, err := lybic.NewClient(nil)
if err != nil {
panic(err)
}
ctx := context.Background()
sandboxes, err := client.ListSandboxes(ctx)
if err != nil {
fmt.Printf("列出沙箱时出错: %v", err)
return
}
fmt.Printf("沙箱: %+v", sandboxes)
}编程式配置
您也可以通过创建 Config 对象,,以编程方式配置客户端。
config := lybic.NewConfig() // 使用默认值和环境变量初始化
config.OrgId = "your-org-id"
config.ApiKey = "your-api-key"
config.Timeout = 20 // 秒
client, err := lybic.NewClient(config)
if err != nil {
panic(err)
}配置选项
SDK 提供以下可配置选项,可通过 Config或环境变量进行设置:
| 结构体字段 | 环境变量 | 描述 | 默认值 |
|---|---|---|---|
OrgId | LYBIC_ORG_ID | 必填。您的组织 ID。 | "" |
ApiKey | LYBIC_API_KEY | 用于身份验证的 API 密钥。 | "" |
Endpoint | LYBIC_API_ENDPOINT | API接口地址URL。 | https://api.lybic.cn |
Timeout | - | HTTP 请求超时时间(秒)。 | 10 |
ExtraHeaders | - | 每次请求附加的 HTTP Header。 | nil |
Logger | - | 自定义日志记录器实例。 | nil(禁用) |