河北電信行業(yè)短信平臺(tái)--接口手冊(cè)

1、06:889006:8890行業(yè)短信平臺(tái)行業(yè)短信平臺(tái)接口手冊(cè)接口手冊(cè)產(chǎn)品名稱(chēng)產(chǎn)品名稱(chēng)行業(yè)短信平臺(tái)行業(yè)短信平臺(tái)發(fā)布日期發(fā)布日期2011-052011-05河北電信行業(yè)短信平臺(tái)-接口手冊(cè) 中國(guó)電信河北分公司 第 2 頁(yè) 共 26 頁(yè)目目 錄錄1 1、引言引言.3 31.1.目的.31.2.修改歷史記錄.31.3.名稱(chēng)解釋.32 2、短信短信.4 42.1.HTTP接口.42.1.1. 短信下行.42.1.2. 短信上行.72.1.3. 短信狀態(tài)報(bào)告.82.1.4. 查詢(xún)余額.92.2.API接口 .102.3.WEBSERVICE接口（不推薦）.14

2、2.3.1. 自定義數(shù)據(jù)結(jié)構(gòu).142.3.2. 短信下行（發(fā)送多條內(nèi)容相同的短信）.162.3.3. 短信下行（發(fā)送多條內(nèi)容不同的短信）.172.3.4.獲取上行.172.3.5.獲取狀態(tài)報(bào)告（單條）.182.3.6.獲取狀態(tài)報(bào)告（多條）.182.3.7. 獲取余額.192.4.WEBSERVICE接口(新，推薦使用).192.4.1. 自定義數(shù)據(jù)結(jié)構(gòu).192.4.2. 短信下行（發(fā)送一條或者多條內(nèi)容相同的短信）.192.4.3. 短信下行（發(fā)送內(nèi)容不同的短信）.202.4.4.獲取上行.212.4.5.獲取狀態(tài)報(bào)告.222.4.6. 獲取余額.232.4.7.短信 webservice（新）

3、錯(cuò)誤碼.242.5.WEBSERVICE接口(支持上下行子號(hào)碼).242.5.1. 自定義數(shù)據(jù)結(jié)構(gòu).242.5.2. 短信下行（發(fā)送一條或者多條內(nèi)容相同的短信）.252.5.3. 短信下行（發(fā)送內(nèi)容不同的短信）.262.5.4.獲取上行.272.5.5.獲取狀態(tài)報(bào)告.282.5.6. 獲取余額.292.5.7.短信 webservice 錯(cuò)誤碼.30河北電信行業(yè)短信平臺(tái)-接口手冊(cè) 中國(guó)電信河北分公司 第 3 頁(yè) 共 26 頁(yè)1 1、 引言引言. 目的目的該接口手冊(cè)編寫(xiě)目的在于描述短信平臺(tái) CTC-EMP（以下簡(jiǎn)稱(chēng) CTC-EMP）具體的接口協(xié)議，供接口用戶(hù)進(jìn)行接口的對(duì)接開(kāi)發(fā)。1.

4、2.1.2. 修改歷史記錄修改歷史記錄版版 本本修改人修改人日日 期期描描 述述5.0.1顧黎杰2006/8/10創(chuàng)建文檔。5.0.2顧黎杰2008/6/20增加短信 api 接口。5.0.3顧黎杰2010/5/5細(xì)化接口返回參數(shù)。5.0.3趙鴻2011/5/6WebService 接口(支持上下行子號(hào)碼)5.3.8王鵬2011/8/26細(xì)化 HTTP 下行 SUBCODE 參數(shù)描述. 名稱(chēng)名稱(chēng)解釋解釋縮略語(yǔ)縮略語(yǔ)英文全名英文全名中文全名中文全名SMSShort Messaging Service短消息服務(wù)MMSMultimedia Message Service多媒體消息API

5、Application Programming Interface應(yīng)用程序編程接口MOMessage Original消息上行MTMessage Terminal消息下行SPService Provider服務(wù)提供商CPContent Provider內(nèi)容提供商河北電信行業(yè)短信平臺(tái)-接口手冊(cè) 中國(guó)電信河北分公司 第 4 頁(yè) 共 26 頁(yè)2 2、 短信短信. http 接口接口.1.1. 短信下行短信下行功能：下發(fā)單條或者多條內(nèi)容相同的短信。地址： 31:8080/emp/http/SendSms。建議采用 post 方法提交請(qǐng)求。

6、請(qǐng)求參數(shù)定義如下： 參數(shù)名稱(chēng)描述字段值A(chǔ)ccount帳號(hào)String，不空。Password密碼String，不空（需 MD5 加密，32 位，加密后字母全部為小寫(xiě)，例如：“ 加密后應(yīng)該等于“cbff36039c3d0212b3e34c23dcde1456”用戶(hù)可以用此例子驗(yàn)證加密方法是否正確） 。SubCode子號(hào)碼String，可以為空。格式為企業(yè)帳號(hào)+子號(hào)碼。例如：如果平臺(tái)號(hào)碼為“10650300” ，企業(yè)帳號(hào)為 2，子號(hào)碼為“22” ，則 SubCode 設(shè)置為“222” ，短信將以“10650300222”號(hào)碼下發(fā)給手機(jī)用戶(hù)(注：此功能需要通道支持)。Phone手機(jī)號(hào)碼String，

7、不空，支持多號(hào)碼，號(hào)碼之間用英文逗號(hào)隔開(kāi)，最多 100 個(gè)。如13900000000。Content短信內(nèi)容String，不空 。GBK 編碼Java 例:.URLEncoder.encode(Content, UTF-8)。WappushurlWappushurlWappush 地址，如果需要發(fā)送Wappush，則 Content 表示 titleSendTime定時(shí)發(fā)送時(shí)間String，可以為空，為空就是立即發(fā)送。定時(shí)發(fā)送格式為年月日時(shí)分，如：200803201615。返回參數(shù)定義如下：河北電信行業(yè)短信平臺(tái)-接口手冊(cè) 中國(guó)電信河北分公司 第 5 頁(yè) 共 26 頁(yè)參

8、數(shù)名稱(chēng)描述response0：成功條數(shù)；-1：帳號(hào)不存在，請(qǐng)檢查用戶(hù)名或者密碼是否正確；-2：賬戶(hù)余額不足；-3：帳號(hào)已被禁用；-4：ip 鑒權(quán)失?。ㄐ枰?ip 校驗(yàn)的場(chǎng)合） ；-8：缺少請(qǐng)求參數(shù)或參數(shù)不正確（請(qǐng)檢查用戶(hù)名，密碼，下發(fā)號(hào)碼，下發(fā)內(nèi)容是否為空，或者下發(fā)號(hào)碼數(shù)量是否大于100 個(gè)） ；-9：內(nèi)容不合法（含有非法內(nèi)容，請(qǐng)檢查下發(fā)內(nèi)容） 。-10：賬戶(hù)當(dāng)日發(fā)送短信量已經(jīng)超過(guò)允許的每日最大發(fā)送量（賬戶(hù)被限制每日發(fā)送短信數(shù)量的情況有用）phone手機(jī)號(hào)。smsID短信 ID（用于匹配狀態(tài)報(bào)告） 。下發(fā)實(shí)例（java）：import java.io.BufferedReader;import

9、 java.io.InputStreamReader;import java.io.OutputStream;import .HttpURLConnection;import .URL;import java.security.MessageDigest;public class HttpSend public static void main(String args) try Long startt = System.currentTimeMillis(); / 短信內(nèi)容String _content = 測(cè)試,見(jiàn)諒;/ 用UTF-8編碼執(zhí)行URLEncode_content = .URLE

10、ncoder.encode(_content, UTF-8);/ 密碼加密String pass = MD5Encode(10);String _url = 1:8080/ctc-emassh/http/SendSms;String _param = Account=10&Password= + pass+ &Phoneamp;Content= + _content+ &SubCode=&SendTime=;URL url = null;HttpURLConnection urlConn = null;u

11、rl = new URL(_url);urlConn = (HttpURLConnection) url.openConnection();河北電信行業(yè)短信平臺(tái)-接口手冊(cè) 中國(guó)電信河北分公司 第 6 頁(yè) 共 26 頁(yè)urlConn.setRequestMethod(POST);urlConn.setDoOutput(true);OutputStream out = urlConn.getOutputStream();out.write(_param.getBytes(GBK);out.flush();out.close();BufferedReader rd = new BufferedRea

12、der(new InputStreamReader(urlConn.getInputStream(), GBK);StringBuffer sb = new StringBuffer();int ch;while (ch = rd.read() -1) sb.append(char) ch);System.out.println(sb);rd.close();Long end = System.currentTimeMillis();System.out.println(發(fā)送 短信 耗時(shí)： + (end - startt); catch (Exception ex) System.out.pr

13、int(ex);public static String MD5Encode(String sourceString) String resultString = null;try resultString = new String(sourceString);MessageDigest md = MessageDigest.getInstance(MD5);resultString = byte2hexString(md.digest(resultString.getBytes(); catch (Exception ex) return resultString;public static

14、 final String byte2hexString(byte bytes) StringBuffer bf = new StringBuffer(bytes.length * 2);for (int i = 0; i bytes.length; i+) if (bytesi & 0 xff) 0 x10) bf.append(0);bf.append(Long.toString(bytesi & 0 xff, 16);河北電信行業(yè)短信平臺(tái)-接口手冊(cè) 中國(guó)電信河北分公司 第 7 頁(yè) 共 26 頁(yè)return bf.toString();失敗返回頁(yè)面示例： - -8 成功返回

15、頁(yè)面示例： - 2 -2c92811a29a0c90c0129a0ca984e0016 -2c92811a29a0c90c0129a0ca984e0015 .1.2. 短信上行短信上行功能：接收若干條手機(jī)用戶(hù)的上行短信（一次最多十條） 。地址： 31:8080/emp/http/GetSms。建議采用 post 方法提交請(qǐng)求。調(diào)用短信上行間隔時(shí)間不小于 30 秒。請(qǐng)求參數(shù)定義如下：參數(shù)名稱(chēng)描述字段值A(chǔ)ccount帳號(hào)String，不空。Password密碼String，不空（需 MD5 加密）

16、 。返回參數(shù)定義如下：參數(shù)名稱(chēng)描述response大于 0：上行短信的條數(shù)，一次最多取 10 條；0：沒(méi)有上行短信；-1：帳號(hào)登陸失?。缓颖彪娦判袠I(yè)短信平臺(tái)-接口手冊(cè) 中國(guó)電信河北分公司 第 8 頁(yè) 共 26 頁(yè)-3：此帳號(hào)被禁用；-4：ip 鑒權(quán)失??；-8：缺少請(qǐng)求參數(shù)。-9：訪(fǎng)問(wèn)速度太快，每次訪(fǎng)問(wèn)間隔不能小于 30 秒phone手機(jī)號(hào)。content短信內(nèi)容；已經(jīng)用 .URLEncoder.encode()編碼；需要用 .URLDecoder.decode()解碼。sendTime上行時(shí)間。無(wú)短信或者參數(shù)錯(cuò)誤返回頁(yè)面示例： - 0 成功返回短信頁(yè)面示例：（一次最多取 10 條）- 3- 1

17、376612345678test2009-02-06 09:01:33.0- 1386612345678%E6%B5%8B%E8%AF%952009-02-06 09:01:33.0- 1396612345678abc2009-02-06 09:01:33.0.1.3. 短信狀態(tài)報(bào)告短信狀態(tài)報(bào)告功能：根據(jù) SmsID 返回短信是否成功發(fā)送到用戶(hù)手機(jī)。地址： 31:8080/emp/http/GetReport。建議采用 post 方法提交請(qǐng)求。調(diào)用短信狀態(tài)報(bào)告間隔時(shí)間不小于 30 秒。河北電信行業(yè)短信平臺(tái)-接口手冊(cè) 中國(guó)電信河北分公司 第 9

18、頁(yè) 共 26 頁(yè)請(qǐng)求參數(shù)定義如下：參數(shù)名稱(chēng)描述字段值A(chǔ)ccount帳號(hào)String，不空。Password密碼String，不空（需 MD5 加密） 。SmsID消息 IDString，不空。返回參數(shù)定義如下：參數(shù)名稱(chēng)描述response大于 0：此消息 ID 所對(duì)應(yīng)的狀態(tài)報(bào)告條數(shù)。最多 100 條；0：沒(méi)有此消息 ID 的狀態(tài)報(bào)告；-1：帳號(hào)登陸失?。?3：此帳號(hào)被禁用；-4：ip 鑒權(quán)失敗；-8：缺少請(qǐng)求參數(shù)。-9：訪(fǎng)問(wèn)速度太快，每次訪(fǎng)問(wèn)間隔不能小于 30 秒phone手機(jī)號(hào)。smsID消息 ID。stat狀態(tài)報(bào)告0：成功；2：發(fā)送失敗。請(qǐng)求錯(cuò)誤返回頁(yè)面示例： - -8 請(qǐng)求成功返回頁(yè)面示

19、例： - 1 -2c92812d1ebf8704011ebf939ba80004 0 河北電信行業(yè)短信平臺(tái)-接口手冊(cè) 中國(guó)電信河北分公司 第 10 頁(yè) 共 26 頁(yè).1.4. 查詢(xún)余額查詢(xún)余額功能：查詢(xún)剩余短信的條數(shù)。地址： 31:8080/emp/http/GetBalance。建議采用 post 方法提交請(qǐng)求。調(diào)用查詢(xún)余額間隔時(shí)間不小于 30 秒。請(qǐng)求參數(shù)定義如下：參數(shù)名稱(chēng)描述字段值A(chǔ)ccount帳號(hào)String，不空。Password密碼String，不空（需 MD5 加密） 。返回參數(shù)定義如下：參數(shù)名稱(chēng)描述re

20、sponse-1：帳號(hào)登陸失??；-3：此帳號(hào)被禁用；-4：ip 鑒權(quán)失??；-8：缺少請(qǐng)求參數(shù)。sms短信余額。mms彩信余額。返回頁(yè)面示例： - 10002000 . api 接口接口相關(guān) jar 包包括：ctc-smsclient.jar，ctc-message.jar，ctc-slidewindow.jar，ctc-sync.jar，ctc-util.jar。注意：只有外部企業(yè)才能使用此接口注意：只有外部企業(yè)才能使用此接口名稱(chēng)initConn功能連接初始化。接口方法public int initConn(String host, int port, String user,

21、String password) 河北電信行業(yè)短信平臺(tái)-接口手冊(cè) 中國(guó)電信河北分公司 第 11 頁(yè) 共 26 頁(yè)輸入說(shuō)明host：CTC-EMP 的 ip；port：CTC-EMP 的端口；user：接口用戶(hù)名；password：接口密碼。輸出說(shuō)明0成功1已經(jīng)登陸2用戶(hù)名錯(cuò)誤3密碼錯(cuò)誤4客戶(hù)端 ip 錯(cuò)誤（需要校驗(yàn) ip 的時(shí)候需要）5 其他名稱(chēng)sendSms功能發(fā)送短信。接口方法public boolean sendSms(String from, String to, String msg) 輸入說(shuō)明from：子號(hào)碼，一般不填寫(xiě)；to：手機(jī)號(hào)碼，支持多號(hào)碼，以英文逗號(hào)隔開(kāi)。建議一次最多10

22、0 個(gè)；msg：短信內(nèi)容。輸出說(shuō)明true：成功；false：失敗。名稱(chēng)onSubmitedSMS功能接收下行短信響應(yīng)。sendSms 方法不直接返回下行響應(yīng)，由此方法返回，此方法為回調(diào)方法，不需要手動(dòng)調(diào)用。接口方法public boolean onSubmitedSMS(ISubmitMsg arg0) 輸入說(shuō)明arg0：下行數(shù)據(jù)結(jié)構(gòu)，具體支段見(jiàn)示例。輸出說(shuō)明true：成功；false：失敗。河北電信行業(yè)短信平臺(tái)-接口手冊(cè) 中國(guó)電信河北分公司 第 12 頁(yè) 共 26 頁(yè)名稱(chēng)onDeliverSMS功能接收上行短信。此方法為回調(diào)方法，不需要手動(dòng)調(diào)用。接口方法public boolean onD

23、eliverSMS(IDeliverMsg arg0) 輸入說(shuō)明arg0：上行數(shù)據(jù)結(jié)構(gòu)，具體支段見(jiàn)示例。輸出說(shuō)明true：成功；false：失敗。名稱(chēng)onMTReportSMS功能接收狀態(tài)報(bào)告。此方法為回調(diào)方法，不需要手動(dòng)調(diào)用。接口方法public boolean onMTReportSMS(IReportMsg arg0)輸入說(shuō)明arg0：狀態(tài)報(bào)告數(shù)據(jù)結(jié)構(gòu)，具體支段見(jiàn)示例。輸出說(shuō)明true：成功；false：失敗。示例程序：import com.chinatricom.message.IDeliverMsg;import com.chinatricom.message.IReportMsg;

24、import com.chinatricom.message.ISubmitMsg;import com.chinatricom.slidewindow.SMSCallback;import com.chinatricom.smsclient.ctcpp.CtcppChannel;import com.chinatricom.smsclient.message.DeliverMsg;import com.chinatricom.smsclient.message.ReportMsg;import com.chinatricom.smsclient.message.SubmitMsg;/* *

25、title: 調(diào)用CTC-SMS API客戶(hù)端接口 SMSUtil.java create on 2010-10-26 copyright (c) * 2010-10-26 * * author * version 1.0 */public class SMSUtil implements SMSCallback public static CtcppChannel _chan = null;河北電信行業(yè)短信平臺(tái)-接口手冊(cè) 中國(guó)電信河北分公司 第 13 頁(yè) 共 26 頁(yè)static / 相關(guān)參數(shù)定義SMSUtil _client = new SMSUtil();String host = 12

26、; / 調(diào)用IP地址int port = 28013; / 調(diào)用IP地址的端口String user = 8888; / 用戶(hù)名String passwd = 8888;/ 密碼int wndSize = 16;int timeout = 60 * 1000; / 連接超時(shí)時(shí)間int trys = 3;int speed = 0;/ 記錄日志System.out.println(start);/ 開(kāi)啟通道_chan = new CtcppChannel(host, port, user, passwd, 1, wndSize, timeout,trys, speed, _clie

27、nt, 0, 0, 1, 1);_chan.start();/* * 這個(gè)函數(shù)接收上行短信，短信的各個(gè)字段都放在DeliverMsg */public boolean onDeliverSMS(IDeliverMsg arg0) DeliverMsg msg = (DeliverMsg) arg0;if (msg != null) System.out.println(收到deliverMsg:phone= + msg.getFrom() + ,內(nèi)容=+ msg.getMsg() + ,to= + msg.getTo();return true;/* * 這個(gè)函數(shù)接收下發(fā)短信的狀態(tài)報(bào)告，它通過(guò)

28、msgid關(guān)聯(lián)到下行短信 result : 0成功 1等待發(fā)送 2失敗 */public boolean onMTReportSMS(IReportMsg arg0) ReportMsg msg = (ReportMsg) arg0;if (msg != null) System.out.println(收到repot: result= + msg.getResult() + );河北電信行業(yè)短信平臺(tái)-接口手冊(cè) 中國(guó)電信河北分公司 第 14 頁(yè) 共 26 頁(yè)return true;/* * 這個(gè)函數(shù)接收下行短信的response，SubmitMsg里面有了result和msgId,這里的msg

29、就是_chan.submit(_msg) * 里面的_msg。 result = 0 表示成功， 其他均為失敗。 */public boolean onSubmitedSMS(ISubmitMsg arg0) SubmitMsg msg = (SubmitMsg) arg0;if (msg != null) System.out.println(收到submit response:result + =+ msg.getResult() + , msgid= + msg.getMsgId();return true;/* * 下發(fā)方法入口 */public static void sendSMS

30、(String phoneNumber, String smsContext) try SubmitMsg _msg = new SubmitMsg();_msg.setChanId(1);_msg.setFrom(1);_msg.setTo(phoneNumber);_msg.setMsg(smsContext);_chan.submit(_msg); catch (Exception e) e.printStackTrace(); finally public static void main(String args) SMSUtil.sendSMS test);

31、. WebService 接口接口地址：31:8080/emp/services/SmsNewOperator河北電信行業(yè)短信平臺(tái)-接口手冊(cè) 中國(guó)電信河北分公司 第 15 頁(yè) 共 26 頁(yè).3.1. 自定義數(shù)據(jù)結(jié)構(gòu)自定義數(shù)據(jù)結(jié)構(gòu)MtNewMessage參數(shù)名稱(chēng)類(lèi)型說(shuō)明smsIdString消息序號(hào)，用來(lái)取狀態(tài)報(bào)告時(shí)候匹配，可以為空，建議不填寫(xiě)，為空時(shí)服務(wù)端會(huì)返回一個(gè)唯一的消息序號(hào)。phoneNumberString手機(jī)號(hào)碼。支持多號(hào)碼，號(hào)碼之間用英文逗號(hào)隔開(kāi),建議最多 100 個(gè)。如13900000000

32、。contentString短信內(nèi)容。scheduleTimeDate下行時(shí)間，可以為空。WappushurlStringWappush 地址，如果需要發(fā)送 Wappush，則 Content 表示 title.3.2. 短信下行（發(fā)送一條或者多條內(nèi)容相同的短信）短信下行（發(fā)送一條或者多條內(nèi)容相同的短信）名稱(chēng)sendSms功能發(fā)送一條或則多條內(nèi)容相同的短信。接口方法sendSms(String account, String password, MtNewMessage message,StringHolder sendResMsg, StringHolder errMsg) 輸

33、入說(shuō)明account 用戶(hù)賬號(hào)；password 用戶(hù)密碼（用 MD5 加密，32 位，加密后字母全部為小寫(xiě)，例如：“ 加密后應(yīng)該等于“cbff36039c3d0212b3e34c23dcde1456”可以用此例子驗(yàn)證加密方法是否正確） ；message對(duì)象，詳情請(qǐng)參照自定義數(shù)據(jù)結(jié)構(gòu)：MtNewMessage。輸出說(shuō)明sendResMsg：發(fā)送情況返回 （當(dāng)errMsg 不為負(fù)值時(shí)該值有效）格式（無(wú)換行符）北電信行業(yè)短信平臺(tái)-接口手冊(cè) 中國(guó)電信河北分公司 第 16 頁(yè) 共 26 頁(yè)2c9281e22c1ac7c2012c1adc8bdb0021132-7errMsg：

34、輸出參數(shù)，小于零時(shí)表示下發(fā)錯(cuò)誤，詳情見(jiàn)錯(cuò)誤碼.3.3. 短信下行（發(fā)送內(nèi)容不同的短信）短信下行（發(fā)送內(nèi)容不同的短信）名稱(chēng)batchSendSms功能發(fā)送一條或則多條內(nèi)容相同的短信。接口方法batchSendSms(String account, String password, MtNewMessage message,StringHolder sendResMsg, StringHolder errMsg) 輸入說(shuō)明account 用戶(hù)賬號(hào)；password 用戶(hù)密碼（用 MD5 加密，32 位，加密后字母全部為小寫(xiě)，例如：“ 加密后應(yīng)該等于“cbff36039c3d0212b

35、3e34c23dcde1456”可以用此例子驗(yàn)證加密方法是否正確） ；message對(duì)象數(shù)組，詳情請(qǐng)參照自定義數(shù)據(jù)結(jié)構(gòu)：MtNewMessage。輸出說(shuō)明sendResMsg：發(fā)送情況返回 （當(dāng)errMsg 不為負(fù)值時(shí)該值有效）格式（無(wú)換行符）北電信行業(yè)短信平臺(tái)-接口手冊(cè) 中國(guó)電信河北分公司 第 17 頁(yè) 共 26 頁(yè)2c9281e22c5d9f77012c5da2d0b7001b150007927992c9281e22c5d9f77012c5da2d0c0001c errMsg：輸出參數(shù)，小于零時(shí)表示下發(fā)錯(cuò)誤，詳情見(jiàn)錯(cuò)誤碼.3.4. 獲取上行獲取上行調(diào)

36、用短信上行間隔時(shí)間不小于 30 秒。名稱(chēng)getSms功能獲取上行短信，一次最多取 10 條。接口方法getSms(String account, String password, StringHolder resMsg,StringHolder errMsg)輸入說(shuō)明account 用戶(hù)賬號(hào)；password 用戶(hù)密碼（用 MD5 加密，32 位，加密后字母全部為小寫(xiě)，例如：“ 加密后應(yīng)該等于“cbff36039c3d0212b3e34c23dcde1456”可以用此例子驗(yàn)證加密方法是否正確） 。輸出說(shuō)明resMsg：返回上行短信（當(dāng)errMsg 不為負(fù)值時(shí)該值有效）格式（無(wú)換行符）：1500

37、0792799河北電信行業(yè)短信平臺(tái)-接口手冊(cè) 中國(guó)電信河北分公司 第 18 頁(yè) 共 26 頁(yè)Test MO! 測(cè)試 Deliver 消息est MO! 測(cè)試 Deliver 消息!沒(méi)有上行時(shí)返回：errMsg：輸出參數(shù)，小于零時(shí)表示下發(fā)錯(cuò)誤，詳情見(jiàn)錯(cuò)誤碼.3.5. 獲取狀態(tài)報(bào)告獲取狀態(tài)報(bào)告調(diào)用短信狀態(tài)報(bào)告間隔時(shí)間不小于 30 秒。名稱(chēng)getReport功能獲取一條或者多條狀態(tài)報(bào)告。接口方法getReport(String account, String password,MtNewMessage message, StringHolder reportM

38、sg, StringHolder errMsg)輸入說(shuō)明account 用戶(hù)賬號(hào)；password 用戶(hù)密碼（用 MD5 加密，32 位，加密后字母全部為小寫(xiě)，例如：“ 加密后應(yīng)該等于“cbff36039c3d0212b3e34c23dcde1456”可以用此例子驗(yàn)證加密方法是否正確） ；MtNewMessage，詳情請(qǐng)參照自定義數(shù)據(jù)結(jié)構(gòu)：MtNewMessage,包含消息序號(hào)和手機(jī)號(hào)碼的對(duì)象數(shù)組。 （只需要填寫(xiě)smsId 和 phoneNumber 字段） 。輸出說(shuō)明reportMsg: 返回狀態(tài)報(bào)告（當(dāng) errMsg 不為負(fù)值時(shí)該值有效）格式（無(wú)換行符）：河北電信行業(yè)短信平臺(tái)-接口手冊(cè) 中

39、國(guó)電信河北分公司 第 19 頁(yè) 共 26 頁(yè)138877878782c9281e22bf60182012bf6025949001a0138877878792c9dd1e22aa6018dd12bf60ff59490550無(wú)狀態(tài)報(bào)告時(shí)返回：errMsg: 輸出參數(shù)，小于零時(shí)表示下發(fā)錯(cuò)誤，詳情見(jiàn)錯(cuò)誤碼.3.6. 獲取余額獲取余額調(diào)用獲取余額報(bào)告間隔時(shí)間不小于 30 秒。名稱(chēng)getBalance功能獲取帳號(hào)余額。接口方法getBalance(String account, String password,StringHolder resMsg, StringHolder errMsg)

40、輸入說(shuō)明account 用戶(hù)賬號(hào)；password 用戶(hù)密碼（用 MD5 加密，32 位，加密后字母全部為小寫(xiě)，例如：“ 加密后應(yīng)該等于“cbff36039c3d0212b3e34c23dcde1456”可以用此例子驗(yàn)證加密方法是否正確） 。輸出說(shuō)明resMsg：返回賬戶(hù)余額（當(dāng) errMsg 不為負(fù)值時(shí)該值有效）格式（無(wú)換行符）：河北電信行業(yè)短信平臺(tái)-接口手冊(cè) 中國(guó)電信河北分公司 第 20 頁(yè) 共 26 頁(yè)043216errMsg: 輸出參數(shù)，小于零時(shí)表示下發(fā)錯(cuò)誤，詳情見(jiàn)錯(cuò)誤碼.3.7. 短信短信 webservicewebservice（新）錯(cuò)誤碼（新）錯(cuò)誤碼-1：輸入?yún)?shù)不

41、正確，請(qǐng)檢查賬戶(hù)，密碼，等輸入?yún)?shù)是否為空-2：賬戶(hù)不存在，請(qǐng)檢查用戶(hù)名密碼是否正確-3：賬戶(hù)已經(jīng)超過(guò)每日發(fā)送短信限制數(shù)量（當(dāng)賬戶(hù)被限制每日發(fā)送量時(shí)有用）-4：客戶(hù)端 ip 地址不正確（當(dāng)需要 ip 校驗(yàn)時(shí)）-5：smsId 與數(shù)據(jù)庫(kù)重復(fù)（下發(fā)短信時(shí)，如果smsId 由客戶(hù)端傳入，該參數(shù)不能重復(fù)）-6：內(nèi)容含有非法關(guān)鍵字，請(qǐng)檢查下發(fā)內(nèi)容。-7：對(duì)應(yīng)的號(hào)碼下發(fā)失敗，下發(fā)號(hào)碼為空或其他錯(cuò)誤，導(dǎo)致該號(hào)碼發(fā)送失敗. WebService 接口接口(支持上下行子號(hào)碼支持上下行子號(hào)碼)地址： 31:8080/emp/services/SmsNewOpera

42、toraddsubCode前提：下發(fā)通道支持子號(hào)碼.4.1. 自定義數(shù)據(jù)結(jié)構(gòu)自定義數(shù)據(jù)結(jié)構(gòu)MtNewMessage參數(shù)名稱(chēng)類(lèi)型說(shuō)明smsIdString消息序號(hào)，用來(lái)取狀態(tài)報(bào)告時(shí)候匹配，可以為空，建議不填寫(xiě)，為空時(shí)服務(wù)端會(huì)返回一個(gè)唯一的消息序號(hào)。phoneNumberString手機(jī)號(hào)碼。支持多號(hào)碼，號(hào)碼之間用英文逗號(hào)隔開(kāi),建議最多 100 個(gè)。如13900000000。contentString短信內(nèi)容。scheduleTimeDate下行時(shí)間，可以為空。WappushurlStringWappush 地址，如果需要發(fā)送 Wappush，則 Conte

43、nt 表示 title河北電信行業(yè)短信平臺(tái)-接口手冊(cè) 中國(guó)電信河北分公司 第 21 頁(yè) 共 26 頁(yè).4.2. 短信下行（發(fā)送一條或者多條內(nèi)容相同的短信）短信下行（發(fā)送一條或者多條內(nèi)容相同的短信）名稱(chēng)sendSms功能發(fā)送一條或則多條內(nèi)容相同的短信。接口方法sendSms(String account, String password, MtNewMessage message,String subCode,StringHolder sendResMsg, StringHolder errMsg) 輸入說(shuō)明account 用戶(hù)賬號(hào)；password 用戶(hù)密碼（用 MD5 加密，3

44、2 位，加密后字母全部為小寫(xiě)，例如：“ 加密后應(yīng)該等于“cbff36039c3d0212b3e34c23dcde1456”可以用此例子驗(yàn)證加密方法是否正確） ；subCode :子號(hào)碼，需要通道支持，手機(jī)終端用戶(hù)收到的信息發(fā)送號(hào)碼將是長(zhǎng)號(hào)碼 + 子號(hào)碼( account + 自定義子號(hào)碼)message對(duì)象，詳情請(qǐng)參照自定義數(shù)據(jù)結(jié)構(gòu)：MtNewMessage。輸出說(shuō)明sendResMsg：發(fā)送情況返回 （當(dāng)errMsg 不為負(fù)值時(shí)該值有效）格式（無(wú)換行符）：150000000002c9281e22c1ac7c2012c1adc8bdb0021132-7errMsg：輸出參數(shù)，小于零時(shí)表示下發(fā)錯(cuò)

45、誤，詳情見(jiàn)錯(cuò)誤碼.4.3. 短信下行（發(fā)送內(nèi)容不同的短信）短信下行（發(fā)送內(nèi)容不同的短信）名稱(chēng)batchSendSms河北電信行業(yè)短信平臺(tái)-接口手冊(cè) 中國(guó)電信河北分公司 第 22 頁(yè) 共 26 頁(yè)功能發(fā)送一條或則多條內(nèi)容相同的短信。接口方法batchSendSms(String account, String password, MtNewMessage message, String subCode,StringHolder sendResMsg, StringHolder errMsg) 輸入說(shuō)明account 用戶(hù)賬號(hào)；password 用戶(hù)密碼（用 MD5 加密，32 位，

46、加密后字母全部為小寫(xiě)，例如：“ 加密后應(yīng)該等于“cbff36039c3d0212b3e34c23dcde1456”可以用此例子驗(yàn)證加密方法是否正確） ；subCode :子號(hào)碼，需要通道支持，手機(jī)終端用戶(hù)收到的信息發(fā)送號(hào)碼將是長(zhǎng)號(hào)碼 + 子號(hào)碼message對(duì)象數(shù)組，詳情請(qǐng)參照自定義數(shù)據(jù)結(jié)構(gòu)：MtNewMessage。輸出說(shuō)明sendResMsg：發(fā)送情況返回 （當(dāng)errMsg 不為負(fù)值時(shí)該值有效）格式（無(wú)換行符）：150007927992c9281e22c5d9f77012c5da2d0b7001b150007927992c9281e22c5d9f77012c5da2d0c0001c 河北電信行業(yè)短信平臺(tái)-接口手冊(cè) 中國(guó)電信河北分公司 第 23 頁(yè) 共 26 頁(yè)errMsg：輸出參數(shù)，小于零時(shí)表示下發(fā)錯(cuò)誤，詳情見(jiàn)錯(cuò)誤碼.4.4. 獲取上行獲取上行調(diào)用短信上行間隔時(shí)間不小于 30 秒。名稱(chēng)getSms功能獲取上行短信，一次最多取 10 條。接口方法getSms(String account, String password, StringHolder resMsg,StringHolder errMsg)輸入說(shuō)明account 用戶(hù)