腾讯云短信Go SDK_AI解决方案_同尘科技

SDK 3.0是云 API 3.0平台的配套工具，您可以通过 SDK 使用所有 短信 API。新版 SDK 实现了统一化，具有各个语言版本的 SDK 使用方法相同，接口调用方式相同，错误码相同以及返回包格式相同等优点。注意发送短信相关接口
一次群发请求最多支持200个号码。签名、正文模板相关接口
个人认证用户不支持使用签名、正文模板相关接口，只能通过短信控制台 管理短信签名 和 管理短信正文模板。如需使用该类接口，请将 “个人认证” 变更为 “企业认证”，具体操作请参见 实名认证变更指引。

前提条件

已开通短信服务，创建签名和模板并通过审核，具体操作请参见 国内短信快速入门。如需发送国内短信，需要先 购买国内短信套餐包。已准备依赖环境：Go 1.9版本及以上。已在访问管理控制台 >API密钥管理 页面获取 SecretID 和 SecretKey。SecretID 用于标识 API 调用者的身份。SecretKey 用于加密签名字符串和服务器端验证签名字符串的密钥，SecretKey 需妥善保管，避免泄露。短信的调用地址为sms.tencentcloudapi.com。

相关资料

各个接口及其参数的详细介绍请参见 API 文档。下载 SDK 源码请访问 Github 仓库 或者 Gitee 仓库。

安装 SDK

通过 go get 安装（推荐）

Github 仓库参见：通过 go get 安装（推荐）Gitee 仓库参见：通过 go get 安装（推荐）

通过源码安装

Github 仓库参见：通过源码安装Gitee 仓库参见：通过源码安装

示例代码

说明所有示例代码仅作参考，无法直接编译和运行，需根据实际情况进行修改，您也可以根据实际需求使用 API 3.0 Explorer 自动化生成 Demo 代码。每个接口都有一个对应的 Request 结构和一个 Response 结构。本文仅列举几个常用功能的示例代码，如下所示。

发送短信

package main
import (    "encoding/json"    "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"    sms "github.com/tencentcloud/tencentcloud-sdk-go/tencentcloud/sms/v20210111" // 引入sms)
func main() {    /* 必要步骤：     * 实例化一个认证对象，入参需要传入腾讯云账户密钥对secretId，secretKey。     * 这里采用的是从环境变量读取的方式，需要在环境变量中先设置这两个值。     * 您也可以直接在代码中写死密钥对，但是小心不要将代码复制、上传或者分享给他人，     * 以免泄露密钥对危及您的财产安全。     * SecretId、SecretKey 查询: https://console.cloud.tencent.com/cam/capi */    credential := common.NewCredential(        // os.Getenv("TENCENTCLOUD_SECRET_ID"),        // os.Getenv("TENCENTCLOUD_SECRET_KEY"),        "SecretId",        "SecretKey",    )    /* 非必要步骤:     * 实例化一个客户端配置对象，可以指定超时时间等配置 */    cpf := profile.NewClientProfile()
    /* SDK默认使用POST方法。     * 如果您一定要使用GET方法，可以在这里设置。GET方法无法处理一些较大的请求 */    cpf.HttpProfile.ReqMethod = "POST"
    /* SDK有默认的超时时间，非必要请不要进行调整     * 如有需要请在代码中查阅以获取最新的默认值 */    // cpf.HttpProfile.ReqTimeout = 5
    /* 指定接入地域域名，默认就近地域接入域名为 sms.tencentcloudapi.com ，也支持指定地域域名访问，例如广州地域的域名为 sms.ap-guangzhou.tencentcloudapi.com */    cpf.HttpProfile.Endpoint = "sms.tencentcloudapi.com"
    /* SDK默认用TC3-HMAC-SHA256进行签名，非必要请不要修改这个字段 */    cpf.SignMethod = "HmacSHA1"
    /* 实例化要请求产品(以sms为例)的client对象     * 第二个参数是地域信息，可以直接填写字符串ap-guangzhou，支持的地域列表参考 https://cloud.tencent.com/document/api/382/52071#.E5.9C.B0.E5.9F.9F.E5.88.97.E8.A1.A8 */    client, _ := sms.NewClient(credential, "ap-guangzhou", cpf)
    /* 实例化一个请求对象，根据调用的接口和实际情况，可以进一步设置请求参数     * 您可以直接查询SDK源码确定接口有哪些属性可以设置     * 属性可能是基本类型，也可能引用了另一个数据结构     * 推荐使用IDE进行开发，可以方便的跳转查阅各个接口和数据结构的文档说明 */    request := sms.NewSendSmsRequest()
    /* 基本类型的设置:     * SDK采用的是指针风格指定参数，即使对于基本类型您也需要用指针来对参数赋值。     * SDK提供对基本类型的指针引用封装函数     * 帮助链接：     * 短信控制台: https://console.cloud.tencent.com/smsv2     * 腾讯云短信小助手: https://cloud.tencent.com/document/product/382/3773#.E6.8A.80.E6.9C.AF.E4.BA.A4.E6.B5.81 */
    /* 短信应用ID: 短信SdkAppId在 [短信控制台] 添加应用后生成的实际SdkAppId，示例如1400006666 */    // 应用 ID 可前往 [短信控制台](https://console.cloud.tencent.com/smsv2/app-manage) 查看    request.SmsSdkAppId = common.StringPtr("1400787878")
    /* 短信签名内容: 使用 UTF-8 编码，必须填写已审核通过的签名 */    // 签名信息可前往 [国内短信](https://console.cloud.tencent.com/smsv2/csms-sign) 或 [国际/港澳台短信](https://console.cloud.tencent.com/smsv2/isms-sign) 的签名管理查看    request.SignName = common.StringPtr("腾讯云")
    /* 模板 ID: 必须填写已审核通过的模板 ID */    // 模板 ID 可前往 [国内短信](https://console.cloud.tencent.com/smsv2/csms-template) 或 [国际/港澳台短信](https://console.cloud.tencent.com/smsv2/isms-template) 的正文模板管理查看    request.TemplateId = common.StringPtr("449739")
    /* 模板参数: 模板参数的个数需要与 TemplateId 对应模板的变量个数保持一致，若无模板参数，则设置为空*/    request.TemplateParamSet = common.StringPtrs([]string{"1234"})
    /* 下发手机号码，采用 E.164 标准，+[国家或地区码][手机号]     * 示例如：+8613711112222， 其中前面有一个+号 ，86为国家码，13711112222为手机号，最多不要超过200个手机号*/    request.PhoneNumberSet = common.StringPtrs([]string{"+8613711112222"})
    /* 用户的 session 内容（无需要可忽略）: 可以携带用户侧 ID 等上下文信息，server 会原样返回 */    request.SessionContext = common.StringPtr("")
    /* 短信码号扩展号（无需要可忽略）: 默认未开通，如需开通请联系 [腾讯云短信小助手] */    request.ExtendCode = common.StringPtr("")
    /* 国内短信无需填写该项；国际/港澳台短信已申请独立 SenderId 需要填写该字段，默认使用公共 SenderId，无需填写该字段。注：月度使用量达到指定量级可申请独立 SenderId 使用，详情请联系 [腾讯云短信小助手](https://cloud.tencent.com/document/product/382/3773#.E6.8A.80.E6.9C.AF.E4.BA.A4.E6.B5.81)。 */    request.SenderId = common.StringPtr("")
    // 通过client对象调用想要访问的接口，需要传入请求对象    response, err := client.SendSms(request)    // 处理异常    if _, ok := err.(*errors.TencentCloudSDKError); ok {        fmt.Printf("An API error has returned: %s", err)        return    }    // 非SDK异常，直接失败。实际代码中可以加入其他的处理。    if err != nil {        panic(err)    }    b, _ := json.Marshal(response.Response)    // 打印返回的json字符串    fmt.Printf("%s", b)
    /* 当出现以下错误码时，快速解决方案参考     * [FailedOperation.SignatureIncorrectOrUnapproved](https://cloud.tencent.com/document/product/382/9558#.E7.9F.AD.E4.BF.A1.E5.8F.91.E9.80.81.E6.8F.90.E7.A4.BA.EF.BC.9Afailedoperation.signatureincorrectorunapproved-.E5.A6.82.E4.BD.95.E5.A4.84.E7.90.86.EF.BC.9F)     * [FailedOperation.TemplateIncorrectOrUnapproved](https://cloud.tencent.com/document/product/382/9558#.E7.9F.AD.E4.BF.A1.E5.8F.91.E9.80.81.E6.8F.90.E7.A4.BA.EF.BC.9Afailedoperation.templateincorrectorunapproved-.E5.A6.82.E4.BD.95.E5.A4.84.E7.90.86.EF.BC.9F)     * [UnauthorizedOperation.SmsSdkAppIdVerifyFail](https://cloud.tencent.com/document/product/382/9558#.E7.9F.AD.E4.BF.A1.E5.8F.91.E9.80.81.E6.8F.90.E7.A4.BA.EF.BC.9Aunauthorizedoperation.smssdkappidverifyfail-.E5.A6.82.E4.BD.95.E5.A4.84.E7.90.86.EF.BC.9F)     * [UnsupportedOperation.ContainDomesticAndInternationalPhoneNumber](https://cloud.tencent.com/document/product/382/9558#.E7.9F.AD.E4.BF.A1.E5.8F.91.E9.80.81.E6.8F.90.E7.A4.BA.EF.BC.9Aunsupportedoperation.containdomesticandinternationalphonenumber-.E5.A6.82.E4.BD.95.E5.A4.84.E7.90.86.EF.BC.9F)     * 更多错误，可咨询[腾讯云助手](https://tccc.qcloud.com/web/im/index.html#/chat?webAppId=8fa15978f85cb41f7e2ea36920cb3ae1&title=Sms)     */}

拉取回执状态

package main
import (    "encoding/json"    "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"    sms "github.com/tencentcloud/tencentcloud-sdk-go/tencentcloud/sms/v20210111" // 引入sms)
func main() {    /* 必要步骤：     * 实例化一个认证对象，入参需要传入腾讯云账户密钥对secretId，secretKey。     * 这里采用的是从环境变量读取的方式，需要在环境变量中先设置这两个值。     * 您也可以直接在代码中写死密钥对，但是小心不要将代码复制、上传或者分享给他人，     * 以免泄露密钥对危及您的财产安全。     * SecretId、SecretKey 查询: https://console.cloud.tencent.com/cam/capi */    credential := common.NewCredential(        // os.Getenv("TENCENTCLOUD_SECRET_ID"),        // os.Getenv("TENCENTCLOUD_SECRET_KEY"),        "xxx",        "xxx",    )    /* 非必要步骤:     * 实例化一个客户端配置对象，可以指定超时时间等配置 */    cpf := profile.NewClientProfile()
    /* SDK默认使用POST方法。     * 如果您一定要使用GET方法，可以在这里设置。GET方法无法处理一些较大的请求 */    cpf.HttpProfile.ReqMethod = "POST"
    /* SDK有默认的超时时间，非必要请不要进行调整     * 如有需要请在代码中查阅以获取最新的默认值 */    // cpf.HttpProfile.ReqTimeout = 5
    /* 指定接入地域域名，默认就近地域接入域名为 sms.tencentcloudapi.com ，也支持指定地域域名访问，例如广州地域的域名为 sms.ap-guangzhou.tencentcloudapi.com */    cpf.HttpProfile.Endpoint = "sms.tencentcloudapi.com"
    /* SDK默认用TC3-HMAC-SHA256进行签名     * 非必要请不要修改这个字段 */    cpf.SignMethod = "HmacSHA1"
    /* 实例化要请求产品(以sms为例)的client对象     * 第二个参数是地域信息，可以直接填写字符串ap-guangzhou，支持的地域列表参考 https://cloud.tencent.com/document/api/382/52071#.E5.9C.B0.E5.9F.9F.E5.88.97.E8.A1.A8 */    client, _ := sms.NewClient(credential, "ap-guangzhou", cpf)
    /* 实例化一个请求对象，根据调用的接口和实际情况，可以进一步设置请求参数     * 您可以直接查询SDK源码确定接口有哪些属性可以设置     * 属性可能是基本类型，也可能引用了另一个数据结构     * 推荐使用IDE进行开发，可以方便的跳转查阅各个接口和数据结构的文档说明 */    request := sms.NewPullSmsSendStatusRequest()
    /* 基本类型的设置:     * SDK采用的是指针风格指定参数，即使对于基本类型您也需要用指针来对参数赋值。     * SDK提供对基本类型的指针引用封装函数     * 帮助链接：     * 短信控制台: https://console.cloud.tencent.com/smsv2     * 腾讯云短信小助手: https://cloud.tencent.com/document/product/382/3773#.E6.8A.80.E6.9C.AF.E4.BA.A4.E6.B5.81 */
    /* 短信应用ID: 短信SdkAppId在 [短信控制台] 添加应用后生成的实际SdkAppId，示例如1400006666 */    request.SmsSdkAppId = common.StringPtr("1400787878")    /* 拉取最大条数，最多100条 */    request.Limit = common.Uint64Ptr(10)
    // 通过client对象调用想要访问的接口，需要传入请求对象    response, err := client.PullSmsSendStatus(request)    // 处理异常    if _, ok := err.(*errors.TencentCloudSDKError); ok {        fmt.Printf("An API error has returned: %s", err)        return    }    // 非SDK异常，直接失败。实际代码中可以加入其他的处理。    if err != nil {        panic(err)    }    b, _ := json.Marshal(response.Response)    // 打印返回的json字符串    fmt.Printf("%s", b)}

统计短信发送数据

package main
import (    "encoding/json"    "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"    sms "github.com/tencentcloud/tencentcloud-sdk-go/tencentcloud/sms/v20210111" // 引入sms)
func main() {    /* 必要步骤：     * 实例化一个认证对象，入参需要传入腾讯云账户密钥对secretId，secretKey。     * 这里采用的是从环境变量读取的方式，需要在环境变量中先设置这两个值。     * 您也可以直接在代码中写死密钥对，但是小心不要将代码复制、上传或者分享给他人，     * 以免泄露密钥对危及您的财产安全。     * SecretId、SecretKey 查询: https://console.cloud.tencent.com/cam/capi */    credential := common.NewCredential(        // os.Getenv("TENCENTCLOUD_SECRET_ID"),        // os.Getenv("TENCENTCLOUD_SECRET_KEY"),        "xxx",        "xxx",    )    /* 非必要步骤:     * 实例化一个客户端配置对象，可以指定超时时间等配置 */    cpf := profile.NewClientProfile()
    /* SDK默认使用POST方法。     * 如果您一定要使用GET方法，可以在这里设置。GET方法无法处理一些较大的请求 */    cpf.HttpProfile.ReqMethod = "POST"
    /* SDK有默认的超时时间，非必要请不要进行调整     * 如有需要请在代码中查阅以获取最新的默认值 */    // cpf.HttpProfile.ReqTimeout = 5
    /* 指定接入地域域名，默认就近地域接入域名为 sms.tencentcloudapi.com ，也支持指定地域域名访问，例如广州地域的域名为 sms.ap-guangzhou.tencentcloudapi.com */    cpf.HttpProfile.Endpoint = "sms.tencentcloudapi.com"
    /* SDK默认用TC3-HMAC-SHA256进行签名     * 非必要请不要修改这个字段 */    cpf.SignMethod = "HmacSHA1"
    /* 实例化要请求产品(以sms为例)的client对象     * 第二个参数是地域信息，可以直接填写字符串ap-guangzhou，支持的地域列表参考 https://cloud.tencent.com/document/api/382/52071#.E5.9C.B0.E5.9F.9F.E5.88.97.E8.A1.A8 */    client, _ := sms.NewClient(credential, "ap-guangzhou", cpf)
    /* 实例化一个请求对象，根据调用的接口和实际情况，可以进一步设置请求参数     * 您可以直接查询SDK源码确定接口有哪些属性可以设置     * 属性可能是基本类型，也可能引用了另一个数据结构     * 推荐使用IDE进行开发，可以方便的跳转查阅各个接口和数据结构的文档说明 */    request := sms.NewSendStatusStatisticsRequest()
    /* 基本类型的设置:     * SDK采用的是指针风格指定参数，即使对于基本类型您也需要用指针来对参数赋值。     * SDK提供对基本类型的指针引用封装函数     * 帮助链接：     * 短信控制台: https://console.cloud.tencent.com/smsv2     * 腾讯云短信小助手: https://cloud.tencent.com/document/product/382/3773#.E6.8A.80.E6.9C.AF.E4.BA.A4.E6.B5.81 */
    /* 短信应用ID: 短信SdkAppId在 [短信控制台] 添加应用后生成的实际SdkAppId，示例如1400006666 */    request.SmsSdkAppId = common.StringPtr("1400787878")    /* 拉取最大条数，最多100条 */    request.Limit = common.Uint64Ptr(10)    /* 偏移量 注：目前固定设置为0 */    request.Offset = common.Uint64Ptr(0)    /* 开始时间，yyyymmddhh 需要拉取的起始时间，精确到小时 */    request.BeginTime = common.StringPtr("2019122400")    /* 结束时间，yyyymmddhh 需要拉取的截止时间，精确到小时     * 注：EndTime 必须大于 BeginTime */    request.EndTime = common.StringPtr("2019122523")
    // 通过client对象调用想要访问的接口，需要传入请求对象    response, err := client.SendStatusStatistics(request)    // 处理异常    if _, ok := err.(*errors.TencentCloudSDKError); ok {        fmt.Printf("An API error has returned: %s", err)        return    }    // 非SDK异常，直接失败。实际代码中可以加入其他的处理。    if err != nil {        panic(err)    }    b, _ := json.Marshal(response.Response)    // 打印返回的json字符串    fmt.Printf("%s", b)}

申请短信模板

package main
import (    "encoding/json"    "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"    sms "github.com/tencentcloud/tencentcloud-sdk-go/tencentcloud/sms/v20210111" // 引入sms)
func main() {    /* 必要步骤：     * 实例化一个认证对象，入参需要传入腾讯云账户密钥对 secretId 和 secretKey     * 本示例采用从环境变量读取的方式，需要预先在环境变量中设置这两个值     * 您也可以直接在代码中写入密钥对，但需谨防泄露，不要将代码复制、上传或者分享给他人     * SecretId、SecretKey 查询: https://console.cloud.tencent.com/cam/capi     */    credential := common.NewCredential(        // os.Getenv("TENCENTCLOUD_SECRET_ID"),        // os.Getenv("TENCENTCLOUD_SECRET_KEY"),        "xxx",        "xxx",    )    /* 非必要步骤:     * 实例化一个客户端配置对象，可以指定超时时间等配置 */
    cpf := profile.NewClientProfile()
    /* SDK 默认使用 POST 方法     * 如需使用 GET 方法，可以在此处设置，但 GET 方法无法处理较大的请求 */    cpf.HttpProfile.ReqMethod = "POST"
    /* SDK 有默认的超时时间，非必要请不要进行调整     * 如有需要请在代码中查阅以获取最新的默认值 */    // cpf.HttpProfile.ReqTimeout = 5
    /* 指定接入地域域名，默认就近地域接入域名为 sms.tencentcloudapi.com ，也支持指定地域域名访问，例如广州地域的域名为 sms.ap-guangzhou.tencentcloudapi.com */    cpf.HttpProfile.Endpoint = "sms.tencentcloudapi.com"
    /* SDK 默认用 TC3-HMAC-SHA256 进行签名，非必要请不要修改该字段 */    cpf.SignMethod = "HmacSHA1"
    /* 实例化 SMS 的 client 对象     * 第二个参数是地域信息，可以直接填写字符串ap-guangzhou，支持的地域列表参考 https://cloud.tencent.com/document/api/382/52071#.E5.9C.B0.E5.9F.9F.E5.88.97.E8.A1.A8 */    client, _ := sms.NewClient(credential, "ap-guangzhou", cpf)
    /* 实例化一个请求对象，根据调用的接口和实际情况，可以进一步设置请求参数    * 您可以直接查询 SDK 源码确定接口有哪些属性可以设置     * 属性可能是基本类型，也可能引用了另一个数据结构     * 推荐使用 IDE 进行开发，可以方便地跳转查阅各个接口和数据结构的文档说明 */    request := sms.NewAddSmsTemplateRequest()    /* 基本类型的设置:     * SDK 采用的是指针风格指定参数，即使对于基本类型也需要用指针来对参数赋值。     * SDK 提供对基本类型的指针引用封装函数     * 帮助链接：     * 短信控制台：https://console.cloud.tencent.com/smsv2     * 腾讯云短信小助手：https://cloud.tencent.com/document/product/382/3773#.E6.8A.80.E6.9C.AF.E4.BA.A4.E6.B5.81     */    /* 模板名称 */    request.TemplateName = common.StringPtr("腾讯云")    /* 模板内容 */    request.TemplateContent = common.StringPtr("{1}为您的登录验证码，请于{2}分钟内填写，如非本人操作，请忽略本短信。")    /* 短信类型：0表示普通短信, 1表示营销短信 */    request.SmsType = common.Uint64Ptr(0)    /* 是否国际/港澳台短信：       0：表示国内短信       1：表示国际/港澳台短信 */    request.International = common.Uint64Ptr(0)    /* 模板备注：例如申请原因，使用场景等 */    request.Remark = common.StringPtr("xxx")    // 通过 client 对象调用想要访问的接口，需要传入请求对象    response, err := client.AddSmsTemplate(request)    // 处理异常    if _, ok := err.(*errors.TencentCloudSDKError); ok {        fmt.Printf("An API error has returned: %s", err)        return    }    // 非 SDK 异常，直接失败。实际代码中可以加入其他的处理    if err != nil {        panic(err)    }    b, _ := json.Marshal(response.Response)    // 打印返回的 JSON 字符串    fmt.Printf("%s", b)}

常见问题

代理设置如有代理的环境下，需要设置系统环境变量https_proxy ，否则可能无法正常调用，抛出连接超时的异常现象。开启 DNS 缓存当前 GO SDK 总是会去请求 DNS 服务器，而没有使用到 nscd 的缓存，可以通过导出环境变量GODEBUG=netdns=cgo，或者go build编译时指定参数-tags 'netcgo'控制读取 nscd 缓存。忽略服务器证书校验虽然使用 SDK 调用公有云服务时，必须校验服务器证书，以识别他人伪装的服务器，确保请求的安全。但某些极端情况下，例如测试时，您可能会需要忽略自签名的服务器证书。以下是其中一种可能的方法：

import "crypto/tls"...    client, _ := cvm.NewClient(credential, regions.Guangzhou, cpf)    tr := &http.Transport{        TLSClientConfig: &tls.Config{InsecureSkipVerify: true},    }    client.WithHttpTransport(tr)...

注意：除非您知道自己在进行何种操作，并明白由此带来的风险，否则不要尝试关闭服务器证书校验。import 导包失败例如报错：imported and not used: "os"，说明“ os ”这个包并未在代码中使用到，去掉即可。

对短信的解决方案有疑惑？想了解解决方案收费？ 联系解决方案专家

腾讯云限时活动1折起，即将结束： 马上收藏

同尘科技为腾讯云授权服务中心，购买腾讯云享受折上折，更有现金返利:同意关联，立享优惠

阿里云解决方案也看看？： 点击对比阿里云的解决方案