短信平台WebService接口文档

网站开发中与短信运营商合作短信接口应用

短信平台WebService接口文档

一、接口地址 http://www.77cn.com.cn/services/esmsservice?wsdl

二、接口说明

Webservice的接口分为以下部分：

1. 短信发送接口

（1）sendSmsAsXml

·接口方法定义：

String sendSmsAsXml(String smsPack, String cpid, String cppwd);

·接口参数说明：

smsPack：Xml格式数据包（电话号，短信内容）

cpid：用户登录名

cppwd：用户密码

·返回值

0表示成功，否则返回错误原因。

smsPack格式如下

<?xml version="1.0" encoding="utf-8" ?>

<sms>

<msg>

<phone>13911111111,13811111111</phone>

<content>xxxxxxxxxx</content>

<spnumber>短信流水号</spnumber>

</msg>

<msg>

....

</msg>

</sms>

（2）sendSmsAsNormal

·接口方法定义：

String sendSmsAsNormal(String phone, String msgcont, String spnumber, String chid, String cpid, String cppwd);

·接口参数说明：

phone：所要发送信息的号码（多个号码请用“，”逗号为开）

如：phone = “13800000000,13900000000”;

msgcont： 短信内容

spnumber：流水号，为Null就行，传空值就可。

chid：通道号

cpid：用户登录名

网站开发中与短信运营商合作短信接口应用

cppwd：用户密码

·返回值

返回值为0则表示提交成功。

（3）getSmsStates

·接口方法定义： String getSmsStates(String cpid,String cppwd);

·接口参数说明：

cpid：用户登录名

cppwd：用户密码

·返回值

<?xml version="1.0" encoding="utf-8" ?>

<smsResult nextID="20">

<result>

< spnumber >短信流水号</ spnumber >

<phone>手机号码</phone>

<status>DELIVRD</status>

<sendtime>2008-12-24 23:58:24</sendtime>

</result>

……………………

</smsResult>

说明:DELIVRD成功，其他失败。

（4）sendMms

·接口方法定义：

String sendMms(String smsPack,String cpid,String cppwd);

·接口参数说明：

smsPack：Xml格式数据包（电话号，短信内容）

cpid：用户登录名

cppwd：用户密码

·返回值

<?xml version="1.0" encoding="utf-8" ?>

<mms>

<page>

<img type='jpg' >BASE64Encoder编码</img>

<text>....</text>

</page>

<page>

<img type='jpg'>BASE64Encoder编码</img>

//此处为空，必须保留该节点

<text>....</text>

</page>

...

</mms>

网站开发中与短信运营商合作短信接口应用

（5）getMmsStates

·接口方法定义：

String getMmsStates(String cpid,String cppwd);

·接口参数说明：

cpid：用户登录名

cppwd：用户密码

·返回值

<?xml version="1.0" encoding="utf-8" ?>

<mmsResult nextID="20">

<result>

< spnumber >短信流水号</ spnumber >

<phone>手机号码</phone>

<status>1000</status>

<sendtime>2008-12-24 23:58:24</sendtime>

</result>

……………………

</mmsResult>

说明:DELIVRD成功，其他失败。

（6）getMoList

·接口方法定义：

String getMoList(String nextId,String cpid,String cppwd);

·接口参数说明：

nextId：

cpid：用户登录名

cppwd：用户密码

·返回值

<?xml version="1.0" encoding="utf-8" ?>

<smsMo nextID="20">

<result>

<phone>手机号码</phone>

<content>1000</ content >

<motime>2008-12-24 23:58:24</sendtime>

</result>

……………………

</smsMo>

三、接口提交注意事项：

1. 接口提交数据一个包不能超过50个号码，50个号码提交一次，否则会提交失败。 2. 短信息内容不能超过70个字符。（包括数字、字母、特殊字符和汉字均为一个字符）

网站开发中与短信运营商合作短信接口应用

四、Demo

Demo说明：

arg)

cppwd });

您可以直接创建一个Java项目，调用这个方法，传入相应参数即可。 java Call方法调用： invokeWebServiceCall(phone, smg, null, chid, cpid, cppwd); /** * Java 形式调用 Webservice * * phone：号码列表 * smg：短信内容 * spName：流水号，为null，不用传参数 * chid：通道号 * cpid：用户名 * cppwd：密码 * */ public static void invokeWebServiceCall(String phone, String smg, String spNumber, String chid, String cpid, String cppwd) { // Webservice所在URL String endpoint = "http://www.77cn.com.cn/services/esmsservice"; // 创建一个服务 (service)调用(call) Service service = new Service(); Call call = null; try { // 通过service创建call对象 call = (Call) service.createCall(); // 设置 service所在URL call.setTargetEndpointAddress(new http://www.77cn.com.cn.URL(endpoint)); // 方法名 (sendSmsAsNormal)与SendSmsAsNormal.java方法名保持一致 call.setOperationName("sendSmsAsNormal"); // Object 数组封装了参数，参数为"Object数组形式",调用processService(String String ret = (String) call.invoke(new Object[] { phone, smg, spNumber, chid, cpid, System.out.println(ret); } catch (ServiceException e) { e.printStackTrace(); } catch (MalformedURLException e) {

网站开发中与短信运营商合作短信接口应用

} e.printStackTrace(); } catch (RemoteException e) { e.printStackTrace(); } finally { if(null == call) { } } } call = null; if(null == service) { service = null;