接口文档>短信发送接口
短信接口说明:自定义短信发送内容,适合:验证码、订单短信、监控提醒、会员群发通知、会员营销群发等。接口支持中国移动、中国联通、中国电信的全国范围手机号码。

1、接口地址

http://api.qirui.com:7891/mt

2、请求示例

GET 或 POST:

http://api.qirui.com:7891/mt?dc=8&un=2288**0010&pw=ae2600e9456f5b0b3abc&sm=【启瑞云】您的验证码是:1234&da=19788888888&tf=3&rf=2&rd=0

3、接口参数

名称 类型 是否必须 示例值 描述
un String 2288**0010 接口短信的APIKey,登录后台可查询
pw String ae2600e9456f5b0b3ab8 接口短信的APISecret,登录后台可查询
da String 19788888888 目标手机号码,多个接受号码以“;”分隔
sm String 【启瑞云】您本次的验证码是:100868,3分钟内有效。 短信内容
dc Int 8
tf Int 3 短信内容编码:3表示utf-8
rf Int 2 返回类型:json为2、xml为1、txt为0。
rd Int 0 状态报告:0表示不需要、1表示需要

4、返回结果

名称 类型 是否必须 示例值 描述
success Bool true 结果代码:true和false
id String 164165568624102110 短信msgid,这个值可以匹配状态报告。
r Int 9103 提交失败返回的错误码。

5、返回示例

提交成功:{"success": true, "id": "164165568624102110"}
提交失败:{"success": false, "r":"9103"}

6、常见错误代码

代码 结果描述 解决方案
9013 手机号码错误 核对da参数是否提交,检查要发送的手机号码格式是否正确
9014 短信内容过长 短信内容过长,短信内容不要超过500字。建议每条短信内容字数控制在300字以内
9020 号码段错误 核对手机号码是否正确,如运营商暂未开通的号码段194
9101 pw验证失败 pw参数值过期或错误,检查接口短信的APISecret值填写是否正确,或联系客服解决
9103 un接口账号错误 核对un参数,检查接口短信的APIKey值填写是否正确
9104 IP鉴权失败 在合法的IP上调用接口,或将该IP添加为鉴权IP
9105 超过最大连接数 超过最大并发请求数,如短信量大请联系客服调整流速
9401 短信接口账号余额不足 请在线充值,或联系客服代充
9433 同一个号码,超过每小时最大下发条数 为了避免对手机用户的骚扰,请避免类似下发,或联系客服
9434 同一个号码,超过全天最大下发条数限制 为了避免对手机用户的骚扰,请避免类似下发,或联系客服

7、注意事项

√ 短信签名规范
    1)短信内容一定要带签名,签名放在短信内容的最前面;
    2)签名格式:【***】,签名内容为三个汉字以上(包括三个);
    3)短信内容不允许双签名,即短信内容里只有一个"【】";
    4)短信签名先申请报备后使用,控制台>接口短信>签名报备;