banner

快乐网视短信接口

1.1   发送短信

1.1.1  发送短信格式HTTP GET或者HTTP POST

http://ip:18002/send.do?ua=xxx&pw=xxx&mb=13900000001&ms=A&ex=01&tm=xxx&dm=xxxx

注意:接入之后最好向管理员申请ip地址绑定,这样能防止被恶意­­尝试造成账号泄露或被锁定(密码连续错误10次将被锁定)

1.1.2  发送短信参数说明

ua:用户名

pw:密码

           密码值为md5pw+tm),tm设置为当前时间,与标准时间误差不能超过30分钟。(注:中间的+号在实际赋值时不要填写, tm格式yyyymmddhhmiss14

mb:目的手机号,多条请用英文逗号隔开,最多10000个号码

ms:发送内容,如果含有空格,百分数等特殊内容,请用utf8方式进行编码,最多500个文字(1个英文或数字也算1个文字)

ex:发送扩展号,对于可扩展的通道,可以根据需要任意扩展,但发送出去总长度不会超过20位,可选参数。

tm:当前时间,格式:yyyymmddhhmiss

dm:定时时间(可以为空),格式:yyyymmddhhmiss

1.1.3  发送短信响应包格式

举例:

0,1112090856000110

意义:

返回值,消息编号

1.1.4  发送短信响应包参数说明:

注意:

A、  响应包里没有账号密码是否正确、是否余额不足、账号状态是否正确的提醒,请通过余额查询接口来做相应检测,如果发生这种情况,管理员会第一时间通知您;

B、  同样的内容对同一个号码发多条,系统会自动去重,这样做是为了避免因重复发送造成的投诉;

返回值

含义

0

发送成功

-1

ua或密码为空

-2

下发号码为空

-3

下发内容为空

-4

内容超长

-5

下发号码超长

-6

ua或密码不正确

-7

余额不足

-8

IP地址鉴权不对

-9

协议类型不对

-99

系统异常

 

1.2   接收短信状态报告

1.2.1  接收状态报告格式(多条POST方式,每次最多100条记录)                                                      

地址:rpturl(接入方提供,可以在管理后台自助配置)

格式:rpturl?data=msgid,mobile,stat|msgid,mobile,stat|msgid,mobile,stat

举例:

rpturl?data=05201617404137,13900000001,DELIVRD|05220128211118,13900000002,DELIVRD|05220141501133,13900000003,MK:0010

1.2.2  接收状态报告参数说明

rpturl:由接入方提供的接收状态报告的地址,通道方把状态报告(消息编号、状态、手机号码,特服号)的数据传给此地址

id:消息ID

st:短信状态报告,stat=DELIVRD表示用户成功接收短信。

mb:手机号码。

1.2.3  接收状态报告响应包

响应“0”即可

1.3   接收短信

1.3.1  接收短信格式(单条POST方式,每次1条记录)

地址:mourl(接入方提供,可以在管理后台自助配置)

格式:mourl?mb=xxx&sc=xxx&ms=xxx

举例:mourl?mb=13900000001&sc=10690001&ms=你好,测试

1.3.2  接收短信参数说明

mourl:由合作方提供的接收上行的地址,通道方把用户回复的短信数据(手机号、特服号、内容)传给此地址。

mb:手机号

sc:特服号

ms:内容(utf8编码)

1.3.3  接收短信响应包

响应 0 即可。

1.4   查询余额

1.4.1  查询余额格式

http://ip:18005/balance.do?ua=xxx&pw=xxx

注意:接入之后最好申请ip地址绑定,这样能防止被恶意尝试造成账号泄露或被锁

1.4.2  查询余额参数说明

ua:用户名;

pw:密码;

1.4.3  查询余额响应包

直接返回余额数字,例如:169082

ua或密码不正确:0

附快乐网视短信接口下载:

快乐网视短信接口说明书V4.1.doc


阅读: 656
本文由中文短信网原创,转载请保留链接!
中文短信网
https://www.zhsms.com/interface/24.html

留言评论

暂无留言