短信平台WebService接口_V1.0

一、W ebservice接口说明

(一)Web Service地址

WSDL:http://*.*.*.* /services/Sms?wsdl

(二)名词说明

上发短信:指的是用户手机编辑短信发送到MAS机;

下发短信:指的是MAS机发送短信到用户手机;

时间格式:yyyymmddhh24miss

返回值:

通用返回值

integer

String

长短信:支持长短信,不管短信有多长,都是通过一次WebService调用完成。

短信长度:能支持1000个汉字。

Username:用户名,采用AZDG加密方式进行加密,该用户名为网页管理员创建,创建

的字段为

帐号(帐号为1-8位以内数字)

Passwrod:密码,采用AZDG加密方式进行加密

密钥为:chinagdn

(三)接口说明(短连接方式)

1.连接webservices接口

(1)接口定义:

public String ConnMas(String username, String password)

(2)参数说明:

Username 用户名

Password 密码

(3)返回值格式说明:

integer

String

(4)返回值名词说明:

2.批量获取上发短信

(1)接口定义:

public String getUpSms(String username, String password, String destaddr) (2)参数说明:

Username 用户名

Password 密码

Destaddr 目的地址,即移动分配号码所带扩展号码,考虑到不同业务系统用同一账号登录调用,则不同业务系统建议扩展号码分开,以便区分

(3)返回值格式说明:

integer

String

string

String

string

string

string

string

string

String

string

string

string

string

(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

String

(4)返回值名词说明:

4.插入下发短信

(1)接口定义:

public String InsertDownSms(String username, String password,String batch, String sendbody)

(2)参数说明:

Username 用户名

Password 密码

Batch: 批次,各个系统用同一账号情况下请用不同批次号码

Sendbody:发送主体

(3)返回值格式说明:

integer

string

destaddr,msgid

……

destaddr,msgid

string

(4)返回值名词说明:

msgid :手机号码,短信唯一标识(如果发送为群发,则返回多个msgid节点),如果msgid范围值<0,则代表短信发送失败,失败原因见错误码表

reserve :保留项,暂时未用

(5)发送主体sendbody格式规范:

50138********李老师201104281017150

……

137********杨老师

,今天下午举行活动

说明:

:多条短信可以拥有多个节点

:源地址,可为空,在现有系统管理员分配号码上再扩展号码.比如:移动分配号码为:106573000573,系统管理员分配号码为:08,该节点填写号码为05,则下发的号码

为:1065730005730805

:手机号码,多个手机号码公用节点,则用英文逗号(,)隔开

:短信内容

是否要状态报告,0,不要,1,要

:要求下发时间,可为空,为空则立即下发.格式:yyyyMMddhhmmss

公共短信内容,可为空,不为空则所有节点内的内容节点,在短信下发时都默认加上节点内容.例如: 两个手机号码节点分别为:李老师,杨老师节点为: ,今天下午举行活动,则短信下发内容分别为:

李老师,今天下午举行活动

杨老师,今天下午举行活动

5.下发短信状态报告

(1)接口定义:

public String getDownSmsResult(String username, String password, String Batch, String cnt)

(2)参数说明:

Username 用户名

Password 密码

Batch: 批次,各个系统用同一账号情况下请用不同批次号码

cnt 获取的短信状态条数 <=10

(3)返回值格式说明:

integer

String

integer

string

integer

integer

string

string

string

string

integer

integer

string

string

string

(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

String

string

integer

integer

string

string

string

……

string

integer

integer

string

string

string

(4)返回值名词说明:

msgid :短信标识(插入下发短信返回的msgid) status : 0是成功,其他失败

msgstatus : 网关状态,0成功,其他失败

resultmsg: 结果说明

senttime:手机获取短信时间

reserve: 预留

(5)备注:

一条下发短信只返回一次状态报告

相关文档
最新文档