目录
一、注册并实名认证
二、开通短信服务
三、获取AccessKey
四、设置短信内容
五、配置短信接口
六、发送短信
七、常见问题FAQ
一、注册并实名认证
使用阿里云短信服务,用户需要先在阿里云注册,并完成个人/企业实名认证。
注意:要发送营销短信的用户,必须完成企业实名认证
1.1 注册阿里云:点此注册
1.2 实名认证:点此认证
1.3 绑定企业支付宝: 点击绑定企业支付宝
二、开通短信服务
2.1.开通短信服务:点击开通短信服务
2.2 子账号页面:点击查看子账号页面
2.3 进入控制台:点击查看控制台页面
2.4.对子账号进行转账,或购买短信包:点击进入子账号开始转账
三、 获取AccessKey
AccessKey 相当于API 秘钥,通过阿里云RAM产品创建后,即可用于管理您的短信API
3.1.创建AccessKey: 点击创建AccessKey
3.1.1登录RAM管理控制台。
3.1.2在左侧导航栏,单击用户管理。
3.1.3 单击目标用户,或创建一个新用户,进入用户详情页面。
3.1.4在用户AccessKey区域,单击创建AccessKey。
3.1.5在弹出的对话框中,展开AccessKey详情查看查看AcessKeyId和AccessKeySecret。然后单击保存AK信息,下载AccessKey信息。
3.2.获取Access Key ID和Access Key Secret:点击查看Access Key ID和Access Key Secret
四、创建短信模板
4.1. 创建签名前查看短信规则和审核规则:短信业务规则,审核规则
4.2. 创建短信
4.2.1创建短信签名
短信中附带的发送者信息,例如入驻企业为:阿里巴巴网络技术有限公司,可以提交的签名为:【阿里巴巴】
1) 通过控制台左侧导航,点击“短信签名”,进入签名管理页
2) 点击右上角“创建短信签名”进入创建签名页,根据用途上传相应证明材料
请根据短信的用途正确选择签名类型,避免申请被驳回
验证码短信:用于发送验证码类短信,如登录验证、支付确认、登录异常等
短信通知:用于发送系统通知类短信,如物流通知、付款回执、状态通知等
推广短信:用于发送营销推广类短信,如会员关怀、新品上线、活动通知等
请根据短信的用途正确选择“自用”、“他用”、“其他”,避免申请被驳回
自用,签名为本账号实名认证公司的公司名/产品名/网站名等:您当前为企业认证,签名使用场景是为您的企业的公司名、产品名或网站名等。
他用,签名为他人(非本账号实名认证公司)公司名/产品名/网站名等:您当前为企业认证,签名使用场景是为您企业之外的其他企业的公司名、产品名或网站名。
其他,签名为“他用”且该企业是学校、医院、机关事业单位、媒体、报社:您当前为企业认证,签名使用场景是为您企业之外的学校、医院、机关事业单位、媒体、报社等公司旗下的公司名、产品名或网站名。
3) 审核通过后,可以在“短信签名”中查看签名内容,该字符串是短信发送接口的必填入参(入参填写请参照https://help.aliyun.com/document_detail/55284.html?spm=5176.doc55327.6.551.ASST2P)
4.2.2创建短信模板 (短信模板即短信的主体内容)
1) 通过控制台左侧导航,点击“短信模板”,进入模板管理页,点击创建模板进入:
2) 编辑短信内容
验证码短信:用于发送验证码类短信,如登录验证、支付确认、登录异常等
短信通知:用于发送系统通知类短信,如物流通知、付款回执、状态通知等
推广短信:用于发送营销推广类短信,如会员关怀、新品上线、活动通知等
3)审核通过后,可以在“短信模板”中查看模板ID,该ID是短信发送接口的必填入参
4.2.3 创建推广短信
1)在短信服务左侧导航页“短信签名”、“短信模板”中,添加短信签名或模板时,首次选择“推广短信”时,需要您确认启用推广短信。推广短信仅针对企业用户开放。
注:推广短信不支持变量。
五、短信接口配置
5.1.设置访问权限控制: 点击访问权限控制
5.1.1 使用主账号登录访问RAM控制台
5.1.2 创建RAM用户 ,或授权给已有的RAM用户
5.1.3 给RAM用户授权
5.1.4 选择短信相关的权限,授权给RAM用户
1、AliyunDysmsFullAccess
用于管理短信服务(SMS)的权限
拥有此权限后
能够使用短信服务控制台的所有操作
能够调用短信服务的所有接口
2、AliyunDysmsReadOnlyAccess
用于只读短信服务(SMS)的权限
拥有此权限后
能够使用短信服务的只读权限,能够看到控制台所有页面,但无法使用新增或删除等功能
能够使用短信服务的查询类接口
*相关文档:短信查询API
3、AliyunCloudCommunicationFullAccess
用于管理云通信财务(CloudCommunication)的权限
拥有此权限后
能够操作子账户转入、转出、申请发票等功能
*相关文档:云通信子账户是什么
4、AliyunCloudCommunicationReadOnlyAccess
用于查询云通信财务(CloudCommunication)的权限
拥有此权限后
能够使用云通信子账户的查询余额、查询充值记录等
5.2 接口调用机制与SDK及DEMO下载:
5.2.1 查看API签名调用机制
5.2.2 下载SDK及DEMO
[JAVA]
[PHP](仅支持5.5以上版本)
[PYTHON]
[.NET]
Node.js(node不支持7.6以下版本)
下载文件清单
api_demo(短信服务API接口调用DEMO工程)
api_sdk(短信服务API接口依赖的SDK)
msg_demo(短信回执消息的DEMO)
msg_sdk(短信回执消息的SDK)
5.3.API文档(含短信发送的入参与编写样例):
短信发送API-JAVA
1) SDK工具包中一共包含了2个类库,一个aliyun-java-sdk-core包,另外一个是alicom-dysms-api包,将这两个包执行mvn package命令或者mvn deploy命令打包出相应的jar包,添加到工程类库中依赖使用。
2) 编写样例程序
短信发送API-PHP
短信发送API-Python
短信发送API—Node.js
短信发送API-.NET
HTTP协议及签名
六、短信发送
6.1 如何使用短信查询API:
短信查询API(QuerySendDetails)—JAVA
1)下载SDK:SDK工具包中一共包含了2个类库,一个aliyun-java-sdk-core包,另外一个是alicom-dysms-api包,将这两个包执行mvn package命令或者mvn deploy命令打包出相应的jar包,添加到工程类库中依赖使用。
2)编写样例程序:``java //设置超时时间 System.setProperty(“sun.net.client.defaultConnectTimeout”, “10000”); System.setProperty(“sun.net.client.defaultReadTimeout”, “10000”);
短信查询API(QuerySendDetails)—PHP
短信查询API(QuerySendDetails)—Python
短信查询API(QuerySendDetails)—Node.js
短信查询API(QuerySendDetails) -.NET
HTTP协议及签名
七、常见问题FAQ
常见短信接口调用错误码和解决办法
短信发送状态回执错误码
什么是限流
充值开票问题
系统短信和营销短信区别
如何防范被盗刷
子账号无法转入余额问题
如何获取App Key和App Secret
什么是子账号