短信平台WebService接口 - V1.0

一、 Webservice接口说明

(一) Web Service地址

WSDL：http://*.*.*.*/services/Sms

(二) 名词说明

上发短信：指的是用户手机编辑短信发送到MAS机； 下发短信：指的是MAS机发送短信到用户手机； 时间格式：yyyymmddhh24miss 返回值：

? 通用返回值

integer

String

? 参数code说明： 0 其他 成功 失败，失败时body节点可为空 长短信：支持长短信，不管短信有多长，都是通过一次WebService调用完成。 短信长度 ：能支持1000个汉字。

Username:用户名,采用AZDG加密方式进行加密 Passwrod:密码,采用AZDG加密方式进行加密 密钥为:chinagdn 加密验证地址为：

http://IP/test.jsp?mobile=手机&username=admin&password=0

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

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格式规范：

5013823549398李老师201104281017150 ……

13777778888杨老师

,今天下午举行活动 说明:

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

:源地址,可为空,在现有系统管理员分配号码上再扩展号码.比如:移动分配号码为: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）备注：

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

本文来源：https://www.bwwdw.com/article/830x.html