Webservice API使用说明
1、Webservice接口说明
(1)短信发送
地址:http:// 121.40.60.163:8081/message/services/sendmsg
Sendmsg 方法:
public String sendmsg(String loginname, String password, String content,String phones,String etnumber)
接口参数:
序号
|
参数名称
|
含义
|
1
|
loginname
|
用户帐号-网站申请的帐号
|
2
|
password
|
用户密码-网站申请的密码
|
3
|
phones
|
下发信息的手机号码,多个手机号用半角逗号分隔,最多支持100个号码,例如:13988888881,13988888882, 13988888883
|
4
|
content
|
下发信息的内容,短短信70个字一条,长短信67个字一条
|
5
|
etnumber
|
扩展号(最多支持五位,格式为数字字符串,如“001”,如不需要扩展号,参数填空值“”即可)
|
返回值:
提交成功:返回短信编号,总发送条数,成功条数,失败条数,例如
“smsid:1;total:1;success:1;lose:0”
提交失败:
“发送对象不能为空”
“发送对象格式不正确,只能为数字和',',号码之间用','隔开”
“扩展号格式不正确,只能为数字且不超过五位数”
“用户名密码不符合条件”
“字数超出最大限制”
“短信内容有敏感词,禁止发送”
“剩余可发短信条数不足”
“网关流量不足,请联系相关管理人员”
“请等待审核”
备注:
smsid短信编号,用于查询本次所有发送短信的状态
(2)余额查询
地址:http:// 121.40.60.163:8081/message/services/balance
Sendmsg 方法:
public String balance(String loginname, String password)
接口参数:
序号
|
参数名称
|
含义
|
1
|
loginname
|
用户帐号-网站申请的帐号
|
2
|
password
|
用户密码-网站申请的密码
|
返回值:
剩余余额:10000
提交失败:
“用户名密码不符合条件”
2、HTTP接口说明:
(1)短信发送
方式:POST
URL: http://121.40.60.163:8081/message/sendMsg?loginname=001&password=001&mobile=1368888888&content=短信&extNo=01
编码格式:UTF-8
URL参数:
参数
|
参数说明
|
loginname
|
用户帐号-网站申请的帐号
|
password
|
用户密码-网站申请的密码
|
mobile
|
下发信息的手机号码,多个手机号用半角逗号分隔,最多支持100个号码,例如:13988888881,13988888882, 13988888883
|
content
|
下发信息的内容,短短信70个字一条,长短信67个字一条
|
extNo
|
扩展号(最多支持五位,格式为数字字符串,如“001”,如不需要扩展号,参数填空值“”即可)
|
返回值:
提交成功:返回短信编号,总发送条数,成功条数,失败条数,例如
“smsid:1;total:1;success:1;lose:0”
提交失败:
“发送对象不能为空”
“发送对象格式不正确,只能为数字和',',号码之间用','隔开”
“扩展号格式不正确,只能为数字且不超过五位数”
“用户名密码不符合条件”
“字数超出最大限制”
“短信内容有敏感词,禁止发送”
“剩余可发短信条数不足”
“网关流量不足,请联系相关管理人员”
“请等待审核”
备注:
smsid短信编号,用于查询本次所有发送短信的状态
(2)余额查询
方式:POST
URL: http://121.40.60.163:8081/message/balance?loginname=001&password=001
编码格式:UTF-8
URL参数:
序号
|
参数名称
|
含义
|
1
|
loginname
|
用户帐号-网站申请的帐号
|
2
|
password
|
用户密码-网站申请的密码
|
返回值:
剩余余额:10000
提交失败:
“用户名密码不符合条件”
3、状态和上行推送有两种形式:socket和http(post):
状态和上行接收需要客户提供接收状态和上行服务端地址:服务端接收发送有两种一种是socket方式:客户开启soctet服务端提供ip和端口,短信平台一旦有数据主动向客户推送状态和上行
状态推送格式:MT短信编号,手机号码,状态; 短信编号,手机号码,状态;……(一次最多推送1000条)其中短信编号就是在提交短信是短信平台返回的smsid值,通过短信编号对比短信状态是否成功。
上行推送格式:MO手机号码,短信内容,通道号; 手机号码,短信内容,通道号;……
状态推送格式例如:MT1,138888888888, DELIVRD;2,136666666666, DELIVRD;3, 136666666666, REJECTD;…… 除DELIVRD和空状态之外其余状态都算失败
上行推送格式例如:MO138888888888,收到,10690****;136666666666,ok,10690*****;136666666666,电话联系,10690*****;……
http方式:客户提供一个httpServlet地址,推送文本格式(编码UTF-8):
状态推送格式:MT短信编号,手机号码,状态; 短信编号,手机号码,状态;……(一次最多推送1000条)
上行推送格式:MO手机号码,短信内容,通道号; 手机号码,短信内容,通道号;……
状态推送格式例如:MT1,138888888888, DELIVRD;2,136666666666, DELIVRD;3, 136666666666, REJECTD;…… 除DELIVRD和空状态之外其余状态都算失败
上行推送格式例如:MO138888888888,收到,10690****;136666666666,ok,10690*****;136666666666,电话联系,10690*****;……
如果提供的地址是域名的 获取type和content字段
开发接口人:李工
QQ:24230137
手机号码:13738083806