普通短信发送
在开发前,先了解接口发送短信的操作流程:
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