今天是2024年6月16日 星期日,欢迎光临本站

首页  > 二次接口  > 服务理念

二次接口

服务理念

第一部分:http 接口

 1. SMS发送接口 http://系统访问腾博会网站腾博会网站腾博会网站地址/servlet/UserServiceAPI?method=sendSMS&isLongSms=0&username=test&password=BASE64(password)&smstype=1&mobile=13866194295,

15375427702&content=短信测试 采用 POST方式提交参数: 参数定义如下: method 值为 sendSMS 发送短信 username 明文用户名 password=BASE64(password) 密码采用BASE64 加密算法 smstype 发送短信的类型: 值为0,1,2 O-卡发 1-网关 2-会员 mobile 手机号码采用英文状态下逗号,分割 content 为发送内容 isLongSms 0-普通短信 1-加长短信 返回值:如果成功返回success;批号ID 否则返回failure;错误提示

2.查看用户账号信息接口 http://系统访问腾博会网站腾博会网站腾博会网站地址/servlet/UserServiceAPI?method=getRestMoney&username=tes&password=BASE64(password) 建议采用 POST方式提交参数: 参数定义如下: method 值为 getRestMoney 获得用户账号信息,可发短信数量 username 明文用户名 password=BASE64(password) 密码采用BASE64 加密算法 返回值:如果成功返回帐号剩余短信数量字符串:如memberSmsNum=684;gateSmsNum=49919;kaSmsNum=49964 memberSmsNum=684 表示会员帐号剩余短信数量 gateSmsNum=49919 表示网关帐号剩余短信数量 kaSmsNum=49964 表示卡发帐号剩余短信数量 如果失败返回如:failure;错误提示

3.获取下行状态报告接口 http://系统访问腾博会网站腾博会网站腾博会网站地址/servlet/UserServiceAPI?method=getSmsReport&username=test&password=BASE64(password) method 值为 getSmsReport 获得用户账号信息,可发短信数量 username 明文用户名 password=BASE64(password) 密码采用BASE64 加密算法 返回值:如果成功则返回XML格式的状态报告信息 如果失败返回如:failure;错误提示 XML节点定义如下 smsreport XML根节点 psreport 子节点,一个节点对应一个下行状态报告 mobile 手机号 username 用户名 smslogid 批号ID,发送成功返回的ID号 status 发送返回的状态 1 代表成功 0-失败 2-不明 sendtime 发送时间 返回如下格式: - - 15275427712 admin 66 1 2012-08-16 01:05:39.0 - 13865193295 admin 66 1 2012-08-16 01:04:07.0 - 15375427702 admin 67 1 2012-08-16 01:03:07.0 - 13866194295 admin 67 1 2012-08-16 01:01:27.0

4.上行回复接口 http://系统访问腾博会网站腾博会网站腾博会网站地址/servlet/UserServiceAPI?method=getRecvSMS&username=test&password=BASE64(password) 返回值:如果成功则返回XML格式的状态报告信息 如果失败返回如:failure;错误提示 XML节点定义如下 smsrerecv XML根节点 psrerecv 子节点,一个节点对应一个上行回复信息 mobile 手机号 receiver 接受人 content 回复内容采用BASE64编码 sendtime 接收时间 返回如下格式XML: - - 15256560065 admin xOPLrbChPw== 2012-06-18 14:56:00.0 - 13866194285 admin u9jP8w== 2012-06-15 21:43:25.0 JAVA 调用范例 BASE64 加密算法方法: /** * encode a specified string useing BASE64Encoder * * @param str * the string to be encoded * @return String * @throws Exception */ public synchronized static String BASE64Encoder(String str) throws Exception { return new sun.misc.BASE64Encoder().encode(str.getBytes()); } 下载OPACHE 的HttpClient包 HttpClient client = new HttpClient(); client.getHostConfiguration().setHost("http://系统访问腾博会网站腾博会网站腾博会网站地址", "80"); PostMethod post = new PostMethod("/servlet/UserServiceAPI"); NameValuePair method = new NameValuePair("method","sendSMS"); NameValuePair smstype= new NameValuePair("smstype","1"); NameValuePair username = new NameValuePair("username", "dddb"); NameValuePair password= new NameValuePair("password", Util .BASE64Encoder("1223"));//密码采用BASE64加密 NameValuePair mobile = new NameValuePair("mobile", "13866194295,15266144263"); NameValuePair content= new NameValuePair("content", "test content"); post.setRequestBody(new NameValuePair[] { method,username,password,mobile,content}); int status = client.executeMethod(post); post.releaseConnection(); JAVA.NET.URL try{ String u = "http://系统访问腾博会网站腾博会网站腾博会网站地址/servlet/UserServiceAPI?method=sendSMS&username=test&password="+BASE64Encoder("123")+"&smstype=1&mobile=13866194295,

15375427702&content=短信测试"; URL url = new URL(u); conn = (HttpURLConnection)url.openConnection(); conn.setDoOutput(true); conn.setRequestMethod("POST"); conn.setUseCaches(false); conn.setRequestProperty("Content-type", "application/x-www-form-urlencoded"); conn.setRequestProperty("Connection", "Close"); conn.setRequestProperty("Content-length", String.valueOf(params.length())); conn.setDoInput(true); conn.connect(); OutputStreamWriter out = new OutputStreamWriter(conn.getOutputStream(), "GBK"); out.write(params.toString()); out.flush(); out.close(); InputStream in = conn.getInputStream(); InputStreamReader r = new InputStreamReader(in); LineNumberReader din = new LineNumberReader(r); String line = null; StringBuffer sb = new StringBuffer(); while((line=din.readLine())!=null) { sb.append(line+"\n"); } //对返回结果解析sb.toString }catch(Exception e){ } ASP调用示例: BASE64加密: Public Function Base64_Encode(bstrSource) Const BASE64_TABLE = "ABCDEFGHIJKLMNOPQRSTUVWXYZabcdefghijklmnopqrstuvwxyz0123456789+/" Dim strTempLine Dim j If bstrSource = "" Then bstrSource = " " End If For j = 1 To (Len(bstrSource) - Len(bstrSource) Mod 3) Step 3 strTempLine = strTempLine + Mid(BASE64_TABLE, (asc(Mid(bstrSource, j, 1)) \ 4) + 1, 1) strTempLine = strTempLine + Mid(BASE64_TABLE, ((asc(Mid(bstrSource, j, 1)) Mod 4) * 16 _ + asc(Mid(bstrSource, j + 1, 1)) \ 16) + 1, 1) strTempLine = strTempLine + Mid(BASE64_TABLE, ((asc(Mid(bstrSource, j + 1, 1)) Mod 16) * 4 _ + asc(Mid(bstrSource, j + 2, 1)) \ 64) + 1, 1) strTempLine = strTempLine + Mid(BASE64_TABLE, (asc(Mid(bstrSource, j + 2, 1)) Mod 64) + 1, 1) Next If Not (Len(bstrSource) Mod 3) = 0 Then If (Len(bstrSource) Mod 3) = 2 Then strTempLine = strTempLine + Mid(BASE64_TABLE, (asc(Mid(bstrSource, j, 1)) \ 4) + 1, 1) strTempLine = strTempLine + Mid(BASE64_TABLE, (asc(Mid(bstrSource, j, 1)) Mod 4) * 16 _ + asc(Mid(bstrSource, j + 1, 1)) \ 16 + 1, 1) strTempLine = strTempLine + Mid(BASE64_TABLE, (asc(Mid(bstrSource, j + 1, 1)) Mod 16) * 4 + 1, 1) strTempLine = strTempLine & "=" ElseIf (Len(bstrSource) Mod 3) = 1 Then strTempLine = strTempLine + Mid(BASE64_TABLE, asc(Mid(bstrSource, j, 1)) \ 4 + 1, 1) strTempLine = strTempLine + Mid(BASE64_TABLE, (asc(Mid(bstrSource, j, 1)) Mod 4) * 16 + 1, 1) strTempLine = strTempLine & "==" End If End If Base64_Encode= strTempLine End Function '以下是调用核心代码 url="http://系统访问腾博会网站腾博会网站腾博会网站地址/servlet/UserServiceAPI?method=sendSMS&username=1test&password="&ufmBase64_Encode("123456")&"&smstype=2&content=短信测试" url=url&"&mobile=13866194295" set http=Server.createobject("Microsoft.XMLHTTP") Http.open "POST",url,false http.setRequestHeader "Content-Length",len(mobile) http.setRequestHeader "Content-Type","application/x-www-form-urlencoded" Http.send(mobile) '获得返回结果 response.write http.responseText '对返回结果处理,如果返回结果为success表示成功,,返回failure;错误提示表示调用失败 如URL为:http://系统访问腾博会网站腾博会网站腾博会网站地址/servlet/UserServiceAPI?method=sendSMS&username=115&password=MTIzNDU2&smstype=2&mobile=13866194295,15375427702&content=短信测试 这里账号为115343785 密码为123456 ,MTIzNDU2为123456进行加密后的字符串,smsType=2为会员发送 为0卡发 为1网关

 

第二部分: web service 接口 WEB SERVICE 接口腾博会网站腾博会网站腾博会网站地址为:站点腾博会网站腾博会网站腾博会网站地址+ /services/userApi?wsdl 如: http://系统访问腾博会网站腾博会网站腾博会网站地址/services/userApi?wsdl

1. SMS发送接口 String sendSms(String username, String password, int smstype, String content, String mobile,int isLongSms ) 参数定义如下: username 明文用户名 password=BASE64(password) 密码采用BASE64 加密算法 smstype 发送短信的类型: 值为0,1,2 O-卡发 1-网关 2-会员 mobile 手机号码采用英文状态下逗号,分割 content 为发送内容 返回值:如果成功返回success 否则返回failure;错误提示

2.查看用户账号信息接口 String getRestMoney(String username, String password) 参数定义如下: method 值为 getRestMoney 获得用户账号信息,可发短信数量 username 明文用户名 password=BASE64(password) 密码采用BASE64 加密算法 返回值:如果成功返回帐号剩余短信数量字符串:如memberSmsNum=684;gateSmsNum=49919;kaSmsNum=49964 memberSmsNum=684 表示会员帐号剩余短信数量 gateSmsNum=49919 表示网关帐号剩余短信数量 kaSmsNum=49964 表示卡发帐号剩余短信数量 如果失败返回如:failure;错误提示

3.获取状态报告接口 String getSmsReport(String username, String password) 参数定义如下: username 明文用户名 password=BASE64(password) 密码采用BASE64 加密算法 成功返回 XML 格式字符串,格式同HTTP 4.返回回复信息 String getRecvSMS(String username, String password) 参数定义如下: username 明文用户名 password=BASE64(password) 密码采用BASE64 加密算法 成功返回 XML 格式字符串,格式同HTTP