短信平台WebService接口_V1.0
一、W ebservice接口说明
(一)Web Service地址
WSDL:http://*.*.*.* /services/Sms?wsdl
(二)名词说明
上发短信:指的是用户手机编辑短信发送到MAS机;
下发短信:指的是MAS机发送短信到用户手机;
时间格式:yyyymmddhh24miss
返回值:
通用返回值
integer
长短信:支持长短信,不管短信有多长,都是通过一次WebService调用完成。
短信长度:能支持1000个汉字。
Username:用户名,采用AZDG加密方式进行加密,该用户名为网页管理员创建,创建
的字段为
帐号(帐号为1-8位以内数字)
Passwrod:密码,采用AZDG加密方式进行加密
密钥为:chinagdn
(三)接口说明(短连接方式)
1.连接webservices接口
(1)接口定义:
public String ConnMas(String username, String password)
(2)参数说明:
Username 用户名
Password 密码
(3)返回值格式说明:
integer
(4)返回值名词说明:
2.批量获取上发短信
(1)接口定义:
public String getUpSms(String username, String password, String destaddr) (2)参数说明:
Username 用户名
Password 密码
Destaddr 目的地址,即移动分配号码所带扩展号码,考虑到不同业务系统用同一账号登录调用,则不同业务系统建议扩展号码分开,以便区分
(3)返回值格式说明:
integer
…
(4)返回值名词说明:
telno :手机号
destaddr:端口号
content :短信内容
msgid :短信唯一标识
receivetime :MAS机接收短信时间
reserve :保留项,暂时未用
(5)备注:
每条上行短信只能获取一次,在无上行短信确认情况下,每条短信最多返回5次
3.获取上行短信确认
(1)接口定义:
public String RspUpSms (String username, String password,String msgid) (2)参数说明:
Username 用户名
Password 密码
msgid :短信唯一标识(批量获取上发短信返回的msgid),多个唯一表示用英文逗号(,)隔开,例如: 122,123,124,125
(3)返回值格式说明:
integer
(4)返回值名词说明:
4.插入下发短信
(1)接口定义:
public String InsertDownSms(String username, String password,String batch, String sendbody)
(2)参数说明:
Username 用户名
Password 密码
Batch: 批次,各个系统用同一账号情况下请用不同批次号码
Sendbody:发送主体
(3)返回值格式说明:
integer
……
(4)返回值名词说明:
msgid :手机号码,短信唯一标识(如果发送为群发,则返回多个msgid节点),如果msgid范围值<0,则代表短信发送失败,失败原因见错误码表
reserve :保留项,暂时未用
(5)发送主体sendbody格式规范:
……
说明:
为:1065730005730805
李老师,今天下午举行活动
杨老师,今天下午举行活动
5.下发短信状态报告
(1)接口定义:
public String getDownSmsResult(String username, String password, String Batch, String cnt)
(2)参数说明:
Username 用户名
Password 密码
Batch: 批次,各个系统用同一账号情况下请用不同批次号码
cnt 获取的短信状态条数 <=10
(3)返回值格式说明:
integer
…
(4)返回值名词说明:
msgid :短信标识(插入下发短信返回的msgid)
status :手机接受状态,0是成功,其他失败
msgstatus : 网关状态,0成功,其他失败
resultmsg: 结果说明
senttime:手机获取短信时间
reserve: 预留
(5)备注:
一条下发短信只返回一次状态报告
6.获取指定下发短信状态
(1)接口定义:
public String getSpecialDownSmsResult(String username, String password,String batch, String msgid)
(2)参数说明:
Username 用户名
Password 密码
Batch: 批次,各个系统用同一账号情况下请用不同批次号码
msgid :短信标识,多个标识可用英文逗号(,)隔开,例如:1000,1002,1003
(3)返回值格式说明:
integer
……
(4)返回值名词说明:
msgid :短信标识(插入下发短信返回的msgid) status : 0是成功,其他失败
msgstatus : 网关状态,0成功,其他失败
resultmsg: 结果说明
senttime:手机获取短信时间
reserve: 预留
(5)备注:
一条下发短信只返回一次状态报告