各服务商介绍
当我们想要使用手机验证码在你的网站或是App上进行某些操作时,我们一般会选用各服务商的短信服务。如果你是学习者,那么短信服务的价钱可能会使你不这么开心。
因为我们在进行短信认证时,如果未收到验证码会重新发送,各大厂商短信到达率都在99%以上,所以我们先来考虑短信服务的价格。
- 腾讯云
- 个人认证赠送100条
- 阿里云
- 如果你是新用户,那么会有以下优惠
- 互亿无线
- 个人认证赠送10条
具体使用
这里只介绍API使用短信服务的方法。
腾讯云
在产品中搜索“短信”
选择免费试用
进入短信控制台后需要创建短信签名,创建短信正文模板
首先我们来创建短信签名,点击创建签名
来到创建签名页面
填写基本信息,有如下注意点
- 你需要有一个可以访问的网站,或者是公众号,或者是小程序,再或者是已经上线的APP
- 这里建议使用公众号,创建简单(如果你有如上几种,那么当我没说)
- 微信公众号注册流程
- 签名内容不要太宽泛,如【短信验证】之类的是通不过的,建议让填啥内容填啥内容
填完基本信息,我们点击提交,一般一个多小时我们就能收到审核信息,如果没有通过,我们可以在根据审核结果对我们的签名进行更改。
下面我们来到创建短信正文模板页面,点击创建模板,腾讯云的创建模板服务不像上面介绍的阿里云,他支持没有签名的情况下创建。
创建模板需要填写的内容很少,可根据自己的需要填写。我们可以同时申请一个不含变量的测试模板,用于下一步的发送测试。
这里我选择的是使用标准模板的第一个,待会让我们看看效果如何。
等待签名和模板审核通过我们就可以使用短信发送服务了。
发送短信
首先准备下载一个xlsx模板文件
将里面的内容改为
进行如下操作
等待文件解析过后,点击发送,等待审核通过(好吧,我的还没通过)
如果你的不含变量的模板通过了审核,那么你可以通过手动输入来
API 发送短信
复制如下代码到你的项目中。
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(无需要可忽略): 国内短信填空,默认未开通,如需开通请联系 [腾讯云短信小助手] */ 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) */ }
整理依赖
$ go mod tidy
上面代码需要修改的部分
- SecretId和SecretKey
将你的SecretId
和SecretKey
进行替换,你可以在下面链接中进行查询
- SdkAppId
可以在短信控制台查询
- 签名内容
可在签名查询查询
- 模板id
可在模板查询查询
- 变量
我的只有一个,使用随机码代替
- 手机号
完善以上信息之后就可以启动项目了,你会在控制台得到
{"SendStatusSet":[{"SerialNo":"3364:308855289816640131310230283","PhoneNumber":"+8613781602834","Fee":1,"SessionContext":"","Code":"Ok","Message":"send success","IsoCode":"CN"}],"RequestId":"0eb2ae0a-4feb-45d3-8028-18fe2b614a56"}
然后在你的测试手机号上得到
发送短信的功能就介绍到这里了,如果你想要了解更多,可以去官方文档查看。
短信 发送短信-API 文档-文档中心-腾讯云 (tencent.com)