智能媒资托管 快速入门（Go SDK）

一、相关资源

·智能媒资托管 SMH 的 Go SDK 源码：源码快速下载

·产品文档：SMH 产品文档

·控制台：SMH 控制台

二、环境配置与准备

·Golang：用于下载和安装 Go 编译运行环境，请前往 Golang 页面 进行下载。

·最低支持的 Go 版本为1.21，推荐使用最新稳定版。

·登录 智能媒资托管控制台，开通 SMH 服务并创建媒体库。获取媒体库 ID（libraryId）和专属域名（basePath）。

三、引入 SDK

client "cnb.cool/tencent/cloud/smh/smh-go-sdk"

四、初始化 SMH 服务

package mainimport ( "context" client "cnb.cool/tencent/cloud/smh/smh-go-sdk")func main() { cfg := client.NewConfiguration() // 设置专属域名（必须），请将 URL 替换为你在控制台获取的专属访问域名 cfg.Servers = client.ServerConfigurations{ { URL: "https://smhxxx.api.tencentsmh.cn", // 替换为你的专属域名 Description: "SMH API Server", }, } apiClient := client.NewAPIClient(cfg)}

五、生成访问令牌

// 生成访问令牌ctx := context.Background()tokenResp, httpRes, err := apiClient.TokenAPI.CreateToken(ctx). LibraryId("your-library-id"). // 媒体库 ID，在媒体托管控制台创建媒体库后获取 LibrarySecret("your-library-secret"). // 媒体库密钥，在媒体托管控制台创建媒体库后获取 SpaceId("your-space-id"). UserId("user-id"). Execute()if err != nil { panic(err)}

请求参数

以下是 Grant 参数支持的权限项：

六、Access Token 续期

Token 有效期（默认 24 小时），过期后需要重新获取。建议在业务代码中实现 Token 续期逻辑：

// Token 续期函数func renewToken(ctx context.Context, smhClient *client.APIClient, libraryId string, accessToken string) (string, error) { resp, _, err := smhClient.TokenAPI.RenewToken(ctx, libraryId, accessToken).Execute() if err != nil { return "", err } if resp != nil && resp.AccessToken != nil { return *resp.AccessToken, nil } return "", fmt.Errorf("renew token failed")}

注意：建议在业务逻辑中提前进行续期以避免请求失败。

七、删除访问令牌

令牌不再需要时可主动删除使其立即失效：

// 删除指定访问令牌（立即失效）_, err := apiClient.TokenAPI.DeleteToken(ctx, "your-library-id", "your-access-token").Execute()if err != nil { panic(err)}// 删除特定用户的全部访问令牌（需要媒体库密钥，可选 ClientId/SessionId 进一步限定范围）_, err = apiClient.TokenAPI.DeleteUserTokens(ctx, "your-library-id"). LibrarySecret("your-library-secret"). UserId("user-id"). Execute()if err != nil { panic(err)}

两个接口成功均返回 HTTP 204，无响应体。

八、使用 API

完成初始化和令牌获取后，即可调用各种 API 进行文件操作。

注意：说明：

注意：Go SDK 没有客户端级别的令牌注入机制，访问令牌通过每次调用的 AccessToken(…) 方法以 query 参数传递；同理 LibraryId/SpaceId 也需在每次调用时显式传入（作为路径参数）。

ctx := context.Background()resp, httpRes, err := apiClient.FileAPI.InfoFile(ctx, "your-library-id", "your-space-id", "/test.txt"). AccessToken("your-access-token"). UserId("user-id"). Info(1). ContentDisposition("inline"). Execute()if err != nil { panic(err)}fmt.Printf("File info: %s, Size: %s\\n", *resp.CosUrl, *resp.Size)