企业短信平台企业API接口说明.doc

企业短信平台企业API接口说明
2010-08-11
版本
时间
更新内容
更新人

2010-08-11
文档成立
李洪英

2010-08-11
,增加了如下功能:
使用基本参数的形式发送短信;
通过xml的形式组织短信并发送;
支持多号码发送,号码间用逗号分隔,号码类别(即各运营商号码,如:小灵通\手机)可混合发送同一条信息;
支持回执确认的操作.
支持上行获取的操作;
返回格式更新为XML的模式,以存放更丰富的返回信息,如:发送状态报告,获取上行;
查询用户余额。
添加彩信发送功能
添加彩信获取状态报告
李洪英
目录
1 企业API接口 4
接口函数说明 4
发送消息函数sendSmsAsXml 5
发送消息函数sendLongSmsAsXml 6
发送消息函数sendSmsAsNormal 7
发送消息函数sendLongSmsAsNormal 7
发送任务状态查询getSmsStates 8
发送任务状态查询sendMms 8
接收消息函数getMmsStates 9
接收消息函数getMoList 10
查询余额getAmount 10
企业接口调用方式 11
C#中的调用 11
PHP中的调用 11
Java的调用方式 13
彩信的调用方式 14
企业API接口
企业API接口的实现使用了WebService的方式,企业用户通过调用WebService的指定接口函数以达到发送和接收短信的目的;
企业接口的服务地址为:
http:// hl. /newesmsservice/services/esmsservice
要查看接口的定义的话则在连接地址下面增加“?WSDL”,即:
http:// hl. /newesmsservice/services/esmsservice?WSDL
接口函数说明
企业接口中提供了九个函数,对应的五短信函数如下:
(1)public String sendSmsAsXml(String smsPack, String cpid, String cppwd);
(2)public String sendLongSmsAsXml(String smsPack, String cpid, String cppwd)
(3)public String sendSmsAsNormal(String phone, String msgcont, String spnumber,String chid, String cpid, String cppwd);
(4)public String sendLongSmsAsNormal(String phone, String msgcont, String spnumber,String chid, String cpid, String cppwd)
(5)public String getSmsStates(String cpid,String cppwd);
(6) public String sendMms(String smsPack, String cpid, String cppwd)
(7) public String getMmsStates(String cpid,String cppwd)
(8) public String getMoList(String nextId,String cpid,String cppwd);
(9) public String getAmount(String cpid,String cppwd,String chid);
sendSmsAsXml 函数为通过基本参数发送消息
sendLongSmsAsXml 函数为通过基本参数发送长消息
sendSmsAsNormal 函数为通过XML发送消息
sendLongSmsAsNormal 函数为通过XML发送长消息
getSmsStates 函数为获取状态报告
sendMms 函数为发送彩信
getMmsStates 函数为获取彩信状态报告
getMoList 函数为获取上行
getAmount 函数为查询余额
发送消息函数sendSmsAsXml
函数定义如下:
public String sendSmsAsXml(String smsPack, String cpid, String cppwd)