一、基础环境准备
配置阿里云短信接口前,需完成以下准备工作:
- 登录阿里云控制台并完成企业实名认证,个人账号可能无法开通短信服务
- 在「短信服务」模块中开通短信功能,选择适用于业务场景的短信类型(如验证码、通知)
- 通过RAM控制台获取AccessKey ID和AccessKey Secret,建议为短信服务创建独立子账号并分配最小权限
二、签名与模板配置
短信签名和模板是发送请求的必要参数,需通过官方审核:
- 签名管理:在控制台创建企业/品牌名称,需提交营业执照等资质文件,审核时间约2小时
- 模板规范:验证码类模板仅允许包含一个变量(如
${code}
),通知类模板需明确变量属性(如${orderID}
) - 模板内容禁止包含第三方链接,中文变量需使用全角符号
类型 | 审核要求 |
---|---|
签名 | 需与营业执照主体一致 |
模板 | 变量数量≤3个 |
三、接口参数对接
调用API时需传递以下核心参数:
- RegionId:固定为
cn-hangzhou
- PhoneNumbers:接收号码需包含国际区号(如+86)
- SignName:使用已审核通过的签名编号
- TemplateCode:通过审核的模板ID(格式如
SMS_123456789
) - TemplateParam:JSON格式变量值,需与模板定义完全匹配
建议通过SDK进行调用,Java项目可添加Maven依赖:
com.aliyun aliyun-java-sdk-dysmsapi 2.1.0
正确配置短信接口参数需遵循「先审核后调用」原则,特别注意签名资质、模板变量格式、API密钥权限三大要素。建议在正式发送前使用测试环境验证参数有效性,并通过发送记录功能监控成功率。