如何接入阿里云短信服务 （完整指南）

目录

一、注册并实名认证

二、开通短信服务

三、获取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

什么是子账号