短信客户通平台接口手册).doc

企信通平台接口手册

企信通平台
接口手册

2010-01-10

目 录

1.1. http接口 3
1.1.1. 短信下行 3
1.1.2. 获取余额 3
1.1.3. java例子 4
1.1.4. ASP例子 4
1.2. WebService接口 6
1.2.1. 短信下行 6
1.2.2. Java例子 6
1.3. 注意事项 7

1.1. http接口
1.1.1. 短信下行
接口地址：http://59.36.99.199/dl/person/SendSms

请求参数定义：
参数名
描述
备注
Account
帐号
不能为空
Password
密码
不能为空
Phone
手机号码
不能为空
号码之间用英文逗号隔开，最多10000个。
如：138888888888,139999999999。
Content
短信内容
不能为空。utf-8编码
Java使用
.URLEncoder.encode(Content, "UTF-8")。
Asp、C#使用
Server.UrlEncode("Content");
SendTime
定时发送时间
可以为空。
定时发送格式为yyyyMMddHHmm，如：200803201615。精确到分

返回值定义：
-1：帐号密码错误
-2：手机号码错误
-4：短信内容不合法
-7：余额不足
-8：请求参数错误
-500：系统错误
成功字符串格式为：0+手机号1;回执ID,手机号2;回执ID,，如：013800000000;12533,13900000000;12533,

1.1.2. 获取余额
接口地址：http://59.36.99.199/dl/person/GetBalance

请求参数定义：
参数名
描述
备注
Account
帐号
不能为空
Password
密码
不能为空

返回值定义：
-1：帐号密码错误
其他：余额,

1.1.3. java例子
到http://hc.apache.org/downloads.cgi下载Commons HttpClient 3.1包

public static void main(String[] args) {
try {
HttpClient httpclient = new HttpClient();

PostMethod post = new PostMethod("http://59.36.99.199/dl/person/SendSms");
post.addParameter("Account", "admin");
post.addParameter("Password", "1");
post.addParameter("Phone", "13788888888,13899999999");
post.addParameter("Content", URLEncoder.encode("测试", "utf-8"));
httpclient.executeMethod(post);
System.out.println(post.getResponseBodyAsString());
} catch (Exception e) {
e.printStackTrace();
}
1.1.4. ASP例子
<%'短信发送程序
Dim SendSmsMsg '错误参数定义
Phone=Trim(Request.Form("Phone")) '发送号码
Content=Trim(Request.Form("Content")) '发送内容
SendTime=Trim(Request.Form("SendTime")) '发送时间

If SendSms(Phone,Message,SendTime) Then
'与网关通讯成功
If SendSmsMsg >= 0 Then
'发送短信成功,返回发送条数,可进一步做成功后续处理
response.write "发送成功:"&SendSmsMsg
response.end
Else
'发送失败,返回错误代码,可进一步做成功后续处理
response.write "发送失败:"&SendSmsMsg
response.end
End if
End If

'------------以下是处理函数片段---------------
Function SendSms(Phone,Message,SendTime)
'-----
'函数说明:短信提交发送
'最后修改:2008-07-18
'By hyq
'
'参数设置说明
'Account，用户帐号
'Password，密码
'------------------------------

Account = "*****"
Password = "******"
set http = Server.CreateObject("Microsoft.XMLHTTP")
http.Open "GET", "http://59.36.99.199/dl/person/SendSms?Account="& Account &"&Password="& Password &"&Phone="&Phone&"&Content="&server.UrlEncode(Content)&"&SendTime="&SendTime&"", false
http.setRequestHeader "Content-type:", "text/xml;charset=GB2312"
http.Send
msg=http.ResponseText
msg=RemoveHTML(msg)
If IsNumeric(msg)=True Then
SendSmsMsg = Int(msg)
SendSms = True
Else
SendSmsMsg = 0
SendSms = False
End if
set http = Nothing
End Function

Function RemoveHTML(strHTML)
'------------------------
'函数说明:过滤XML文档标签
'最后修改:2007-04-15
'By Chener
'------------------------

Dim objRegExp, Match, Matches

Set objRegExp = New Regexp

objRegExp.IgnoreCase = True
objRegExp.Global = True
objRegExp.Pattern = "<.+?>"
Set Matches = objRegExp.Execute(strHTML)

For Each Match in Matches
strHtml=Replace(strHTML,Match.Value,"")
Next
RemoveHTML=strHTML
Set objRegExp = Nothing
End Function
%>

1.2. WebService接口

1.2.1. 短信下行
接口地址：http://59.36.99.199/dl/services/SmsWebservices
接口方法：public String sendSms(String account, String password, String phone, String content, String sendTime)
请求参数定义：同1.1.1
返回值定义：同1.1.1

1.2.2. Java例子
public static void main(String[] args) throws Exception {
String endpoint = "http://59.36.99.199/dl/services/SmsWebservices";
Service service = new Service();
Call call = (Call) service.createCall();
call.setTargetEndpointAddress(new .URL(endpoint));
call.setOperationName("sendSms");
String ret = (String) call.invoke(new Object[] { "admin","1","13899999999,13788888888","测试","" });
System.out.println(ret);
}

1.3. 注意事项
接口每次接收号码数最大上限为2万个，群发数大于时，请分包提交到接口。

第 7 页 共 7 页