验证类
营销类
通知类
增值服务
普通短信发送
在开发前，先了解接口发送短信的操作流程：
1、注册账号：用户接入秒赛科技短信功能，首先需要用户在秒赛科技官网注册账号；
2、身份认证：注册后在用户中心，完成身份认证信息（支持企业认证&个人认证）；
3、创建签名：在对应的产品栏目的【签名管理】-新增签名，审核通过后即可调用；
4、创建模板：在对应的产品栏目的【模板管理】-添加短信模板，审核通过即可调用（注：接口调用模板需与审核通过的模板内容完全匹配才能发送）；
5、接口对接：开发调试过程请查看下方 API文档 和 demo示例，接入后可使用?#20302;?#36192;送的短信条数进行测试；
6、套?#32479;?#20540;：测试条数有限，未避免影响正常使用，测试成功后请尽快充值，在短信平台【我要充值】栏目充值短信套餐。
............................................................................................................................................................................................................................................................................................................................
本文档主要定了短信平台对用户开放的主要接口和定义。
用户通过HTTP的Get,POST方式提交短信发送请求。
1.短信提交地址
验证码通知短信地址
http://139.196.108.241:8080/Api/HttpSendSMYzm.ashx
营销短信地址
http://139.196.108.241:8080/Api/HttpSendSMYx.ashx
语音验证码地址
http://139.196.108.241:8080/Api/HttpSendSMVoice.ashx
2.参数定义
| 序号 | 参数 | 说明 |
| 1 | account | 必填参数。用户账号 |
| 2 | ts | 可选参数，时间戳，格式yyyyMMddHHmmss |
| 3 | pswd | 必填参数。用户密码，ts参数为空时填明文密码，ts参数不为空时填md5(账号+密码+时间戳)，对账号密码时间戳拼接的?#22336;?#20018;进行md5?#29992;?/td> |
| 4 | mobile | 必填参数。合法的手机号码，号码间用英文逗号?#25351;簟?#26368;大50000个号码 |
| 5 | msg | 必填参数。短信内容，长度不能超过700个?#22336;?#20351;用URL方式编码为UTF-8格式。短信内容超过70个?#22336;?#26102;，会被拆分成多条，然后以长短信的格式发送。 |
| 6 | sms_sign | 短信签名。默认不需要传，需要使用特定签名时可添加此参数 |
3.短信提交响应
用户短信通过http请求提交到服务器后，服务器返回响应
（1）返回JSON格式说明
{
"result": 0,
"result_msg": "提交成功",
"msgid": "1670510103017877300",
"ts": "20180510103019"
}
result为响应状态（0表示成功，其他表示失败），result_msg 为提示消息，ts为响应时间,msgid 为消息id,状态匹配使用
（3）响应状态值说明
代码 | 说明 |
-1 | 一般错误 |
0 | 提交成功 |
101 | 无此用户 |
102 | 密码错 |
103 | 提交过快（提交速度超过流速限制） |
104 | ?#20302;?#24537;（因平台侧原因，暂时无法处理提交的短信） |
105 | 敏感短信（短信内容包含敏感词） |
106 | 消息长度错（>700或<=0） |
107 | 包含错误的手机号码 |
108 | 手机号码个数错（>50000或<=0） |
109 | 无发送额度（该用户可用短信条数为0） |
110 | 不在发送时间内 |
111 | 超出该账户当月发送额度限制 |
112 | 无此产品，用户没有订购该产品 |
115 | 自动审核驳回 |
116 | 签名不合法，?#21019;?#31614;名（用户必须带签名的前提下） |
117 | IP地址认证错,请求调用的IP地址不是?#20302;?#30331;记的IP地址 |
118 | 用户没有相应的发送权限 |
119 | 用户已过期 |
120 | 内容不在白名单模板中 |
4.注意事项
用户群发短信如果有审核的限制，则客户的短信必须经过管理人员的审核，审核通过后才能被提交?#21483;幸低?#20851;进行短信实际发送。
5.短信发送例子
验证码发送:
http://139.196.108.241:8080/Api/HttpSendSMYzm.ashx?account=xx&pswd=xx&mobile=xx&msg=xx
营销短信发送:
http://139.196.108.241:8080/Api/HttpSendSMYx.ashx?account=xx&pswd=xx&mobile=xx&msg=xx
语音验证码发送:
http://139.196.108.241:8080/Api/HttpSendSMVoice.ashx?account=xx&pswd=xx&mobile=xx&msg=xx
