本文介绍了短信发送功能的实现。通过本文,用户可以快速为网站、APP应用和小程序接入短信发送服务。支持发送验证、通知和推广短信内容。适用于会员注册、验证码登录、预警通知、物流通知场景。短信可以发送至全国移动、联通、电信运营商手机号码。
免费注册互亿无线短信平台会员(平台将自动为每位会员免费试用短信)
短信业务流程说明
登录互亿无线短信平台可以查看短信发送功能使用向导,查看API接口文档。
接口说明:
1、接口功能:支持短信发送、回执推送、余额查询、上行回复推送;
2、提交方式:GET/POST;
3、加密方式:
? 采用HTTPS协议提交请求
? 通过MD5动态签名方式加密
4、短信模板:测试期间,须使用系统默认的模板进行测试,默认模板内容:您的验证码是:1234。请不要把验证码泄露给其他人。
5、短信签名:调试期间,须使用系统默认签名【互亿无线】
提供完整的DEMO示例方便开发者接入,提供多种开发语言,如JAVA、PHP、Python、C++等。
使用平台提供的短信插件,可以快速接入短信发送功能。
在页面中查找专属的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。
在官网进行认证账号。
购买短信套餐
添加短信验证码、通知模板,审核后即可使用自定义模板发送。
设置自定义签名,支持使用公司、APP应用、网站、系统名称。
150,000家
企业客户
20年
行业经验
2V1
2对1客户支持