本文介绍了短信发送功能的实现，通过该文章，用户可以为自己的网站、App、小程序等快速接入短信发送功能。支持发送验证、通知及营销类短信内容。适用于用户注册、会员登录、找回密码、订单通知场景。短信可发送至移动、联通、电信运营商手机号码。

rubysms开发教程

1、免费注册短信账号

免费注册互亿无线短信平台会员（平台会自动免费给每个会员赠送测试短信）

2、短信发送逻辑

短信实现流程说明

3、查看短信API接口文档

登录互亿无线短信平台可以查看短信发送功能使用向导，查看API接口文档。

接口说明：
1、接口功能：支持短信发送、回执推送、余额查询、上行回复推送；
2、提交方式：GET/POST；
3、加密方式：
• 采用HTTPS协议提交请求
• 通过MD5动态签名方式加密
4、短信模板：测试期间，须使用系统默认的模板进行测试，默认模板内容：您的验证码是：1234。请不要把验证码泄露给其他人。
5、短信签名：调试期间，须使用系统默认签名【互亿无线】

4、查看短信DEMO示例

提供完整的DEMO示例方便开发者接入，提供多种开发语言，如JAVA、PHP、Python、C++等。

5、下载短信插件

提供各类系统的短信插件，无需开发即可接入短信功能。

6、短信接口提交测试

在接口请求参数中找到自己的APIID和APIkey；

通过POST、 GET 方式进行短信提交，数据编码采用utf-8格式，请求地址为：https://106.ihuyi.com/webservice/sms.php?method=Submit。请求参数如下：

参数名称	参数值描述	必填
account	APIID(用户中心【验证码通知短信】-【产品纵览】查看)	是
password	1、APIKEY(用户中心【验证码通知短信】-【产品纵览】查看) 2、动态密码(生成动态密码方式请看该文档末尾的说明)	是
mobile	接收手机号码，只能提交1个号码	是
content	短信内容(编码格式为 UTF-8，支持 300 个字的长短信，长短信 按多条计费) 例如:您的验证码是:1234。请不要把验证码泄露给其他人。	是
time	Unix时间戳（10位整型数字，当使用动态密码方式时为必填）	否
format	返回格式（可选值为：xml或json，系统默认为xml）	否

用户通过http 或 https提交发送短信请求到服务器后，服务器会返回一串xml格式的字符串，SubmitResult结构说明如下：

参数名称	类型	描述
code	int	返回值为2时，表示提交成功
smsid	string	当提交成功后，此字段为流水号，否则为0
msg	string	提交结果描述

响应示例：

运行函数后，查看接口的提交状态，确保接口请求提交是成功的，如果不成功，可根据接口返回的状态，查到对应的原因，根据具体原因来进行调试。

code	msg
0	提交失败
2	提交成功
400	非法ip访问
401	帐号不能为空
402	密码不能为空
403	手机号码不能为空
4030	手机号码已被列入黑名单
404	短信内容不能为空
405	API ID 或 API KEY 不正确
4050	账号被冻结
40501	动态密码已过期
40502	动态密码校验失败
4051	剩余条数不足
4052	访问 ip 与备案 ip 不符
406	手机格式不正确
407	短信内容含有敏感字符
4070	签名格式不正确
4071	签名格式不正确
4072	签名格式不正确
40722	变量内容超过指定的长度【8】
4073	短信内容超出长度限制
4074	短信内容包含 emoji 符号
4075	签名未通过审核
408	发送超限([20]条)，已加入黑名单，可登入平台解除
4080	同一手机号码同一秒钟之内发送频率不能超过 1 条
4082	超出同一手机号一天之内【5】条短信限制
4085	同一手机号验证码短信发送超出【5】条

请求示例：

http://106.ihuyi.com/webservice/sms.php?method=Submit&account=APIID&password=APIKEY&mobile=手机号码&content=您的验证码是:1234。请不要把验证码泄露给其他人。
  

发送成功，手机可收到短信。

如遇到提交异常时，可使用官方提供的在线调试工具。

短信接口除了提交短信能力外，还提供余额查询、发送回执推送等能力。

如发送中遇到问题，可联系在线客服，电话：4008808898。

7、验证码通知短信开通流程

已封装的成熟的短信接口，让可以在15分钟内完成验证码通知接口的接入。