为方便您更好地使用火山引擎短信服务,我们为开发者封装了SDK for Go,开发者可通过下载SDK直接调用短信服务。
以下将以SendSms接口为例,为您介绍如何下载SDK,并调用短信服务向收件人发送短信。
Go 1.13.1 或更高版本
获取了AK (Access Key) 和 SK (Secret Key)
小贴士:一个火山引擎账号最多可以同时申请两对 AK/SK 。
SDK for Go提供了示例 demo_sms_test.go ,以便开发者可以快速调用SendSms API。
可以根据以下步骤下载SDK:
方式一:git clone
https://github.com/volcengine/volc-sdk-golang.git
方式二:
点击 Code -> Download ZIP
在终端窗口运行以下请求来安装SDK for Go
go get -u
github.com/volcengine/volc-sdk-golang
打开示例文件 demo_sms_test.go
要通过 AK/SK 设置身份验证。可以按照下面的示例在示例文件中填写您的 AK 和 SK。
推荐按照以下方式设置身份验证:
testAk = "testAK" testSk = "testSk"
或者,您也可以在环境变量设置中填写您的 AK 和 SK,如下所示。
VOLC_ACCESSKEY="your ak" VOLC_SECRETKEY="your sk"
否则,您可以通过在~/.volc/config 下创建一个JSON文件来设置您的AK和SK,如下所示。
{"ak":"your ak","sk":"your sk"}
package main import ( "github.com/volcengine/volc-sdk-golang/service/sms" ) func main() { testAk, testSk := "", "" sms.DefaultInstance.Client.SetAccessKey(testAk) sms.DefaultInstance.Client.SetSecretKey(testSk) req := &sms.SmsRequest{ SmsAccount: "smsAccount", Sign: "sign", TemplateID: "ST_xxx", TemplateParam: "", PhoneNumbers: "188xxxxxxxx", Tag: "tag", } result, statusCode, err := sms.DefaultInstance.Send(req) if err != nil { println("sms send err:%s", err.Error()) return } println("result is :%s, statusCode is:%d", result, statusCode) }
go test -v example/demo_sms/demo_sms_test.go
短信发送后,您将收到一条包含MessageID的发送成功的响应。响应参数详见SendSms。