? Copyright 2004-2018 動(dòng)力思維 All Rights Reserved www.iium.cn
增值電信業(yè)務(wù)經(jīng)營許可證：B2-20090494 備案號(hào)：豫B2-20100056-8
增值電信業(yè)務(wù)經(jīng)營許可證：B2-20090494 備案號(hào)：豫B2-20100056-8
手機(jī)的高度普及，讓短信接口廣泛應(yīng)用于各行各業(yè)，有不少人在接入短信接口時(shí)不知該如何下手，下面就以目前非常主流的java語言為例，為大家分享一個(gè)動(dòng)力思維樂信調(diào)用Http協(xié)議的短信接口java demo。
1、注冊(cè)短信接口平臺(tái)賬戶：http://www.iium.cn/acc/x5?i=110792
2、登錄短信接口平臺(tái)，申請(qǐng)短信接口使用，或者聯(lián)系客服開通，400電話：400-6699-521。
3、下載完整接口文件，下載地址：http://www.iium.cn/api/sdk_php.zip。
4、demo核心代碼段如下，（完整demo下載地址：http://www.iium.cn/api/java.zip）：
String sendSms(String accName,String accPwd,String mobies,String content){
StringBuffer sb = new StringBuffer("http://www.iium.cn/sdk/send?");
try {
sb.append("&accName="+accName);
sb.append("&accPwd="+md5(accPwd));
sb.append("&aimcodes="+mobies);
sb.append("&content="+URLEncoder.encode(content,"UTF-8"));
sb.append("&dataType=string");
URL url = new URL(sb.toString());
HttpURLConnection connection = (HttpURLConnection) url.openConnection();
connection.setRequestMethod("POST");
BufferedReader in = new BufferedReader(new InputStreamReader(url.openStream()));
return in.readLine();
} catch (Exception e) {
e.printStackTrace();
}
return null;
}
短信接口相關(guān)說明：
一、接口說明
1、提交方式與編碼
http請(qǐng)求都應(yīng)以POST形式提交,編碼為UTF-8
2、請(qǐng)求地址
請(qǐng)求地址(host)為: https://www.lx198.com/sdk/
不同的協(xié)議擁有不同的提交地址 方式是在以上地址后面增加相應(yīng)的地址；
二、主體協(xié)議
1、發(fā)送短信
發(fā)送普通短信調(diào)用此方法，可單個(gè)或批量發(fā)送。
注意：①、短信內(nèi)容格式為：短信內(nèi)容【簽名】，要使用中文’【‘。
2、發(fā)送地址
https://host/send
3、發(fā)送參數(shù)
|
字段名稱 |
是否可空 |
說明 |
|
accName |
否 |
用戶名(樂信登錄賬號(hào)) |
|
accPwd |
否 |
密碼(樂信登錄密碼32位MD5加密后轉(zhuǎn)大寫，如123456加密完以后為：E10ADC3949BA59ABBE56E057F20F883E) |
|
aimcodes |
否 |
手機(jī)號(hào)碼(多個(gè)手機(jī)號(hào)碼之間用英文半角,”隔開,單次最多支持5000個(gè)號(hào)碼) |
|
content |
否 |
內(nèi)容(內(nèi)容長度請(qǐng)參照樂信(https://www.lx198.com)發(fā)送短信頁面提示)，注意：在內(nèi)容的最后需要加上在樂信(https://www.lx198.com)設(shè)置并通過審核的簽名。如：公司定于1月25日召開今年的企業(yè)年會(huì)，請(qǐng)務(wù)必安排好時(shí)間?！緞?dòng)力思維】 |
|
schTime |
是 |
定時(shí)時(shí)間(格式為: 如為空則為即時(shí)短信,如需定時(shí)時(shí)間格式為yyyy-mm-dd hh24:mi:ss”) |
|
dataType |
是 |
返回的數(shù)據(jù)(類型支持:json/xml/string 三種形式 默認(rèn)string) |
|
msgId |
是 |
提交短信包的唯一id，推送短信回執(zhí)時(shí)，會(huì)推送此值，用此值和手機(jī)號(hào)碼來匹配短信的狀態(tài)，如需要接受回執(zhí)則必須提交此參數(shù),單次提交只需要提交一個(gè)即可 |
接口測(cè)試實(shí)例，可以在瀏覽器中直接輸入測(cè)試（建議使用POST方式）
https://www.lx198.com/sdk/send?accName=***&accPwd=***&aimcodes=***&content=內(nèi)容【簽名】&bizId=***&dataType=string
4、發(fā)送響應(yīng)Json格式
|
字段名稱 |
類型 |
說明 |
|
replyCode |
整型 |
執(zhí)行結(jié)果 1 成功 0失敗 |
|
replyMsg |
Text |
成功或失敗原因具體信息 |
|
succeedNum |
整型 |
成功條數(shù)(當(dāng)次提交成功的手機(jī)號(hào)碼個(gè)數(shù)) |
|
failedNum |
整型 |
失敗條數(shù)(當(dāng)次提交失敗的手機(jī)號(hào)碼個(gè)數(shù)) |
|
chargCount |
整型 |
計(jì)費(fèi)條數(shù)(當(dāng)次提交計(jì)費(fèi)的短信條數(shù)) |
|
deduction |
整型 |
計(jì)費(fèi)金額(當(dāng)次提交的計(jì)費(fèi)金額,單位:厘) |
|
balance |
整型 |
余額(當(dāng)次提交后的賬戶余額:單位:厘) |
示例:
{"balance":"12882680","chargCount":61,"deduction":"3660","failedNum":0,"replyCode":1,"replyMsg":"發(fā)送成功!","succeedNum":61}
5、發(fā)送相應(yīng)xml格式
|
字段名稱 |
類型 |
說明 |
|
replyCode |
整型 |
執(zhí)行結(jié)果 1 成功 0失敗 |
|
replyMsg |
文本 |
成功或失敗原因具體信息 |
|
succeedNum |
整型 |
成功條數(shù)(當(dāng)次提交成功的手機(jī)號(hào)碼個(gè)數(shù)) |
|
failedNum |
整型 |
失敗條數(shù)(當(dāng)次提交失敗的手機(jī)號(hào)碼個(gè)數(shù)) |
|
chargCount |
整型 |
計(jì)費(fèi)條數(shù)(當(dāng)次提交計(jì)費(fèi)的短信條數(shù)) |
|
deduction |
整型 |
計(jì)費(fèi)金額(當(dāng)次提交的計(jì)費(fèi)金額,單位:厘) |
|
balance |
整型 |
余額(當(dāng)次提交后的賬戶余額,單位:厘) |
示例:
<?xml version="1.0" encoding="UTF-8"?> <SendSmsReply> <replyCode>1</replyCode> <replyMsg>發(fā)送成功!</replyMsg> <succeedNum>61</succeedNum> <failedNum>0</failedNum> <deduction>3660</deduction> <balance>12028040</balance> <chargCount>61</chargCount> </SendSmsReply>
6、發(fā)送相應(yīng)string格式
說明:
多個(gè)響應(yīng)參數(shù)之前以”;”隔開,格式為:成功或失敗代碼;成功或失敗信息;成功條數(shù);失敗條數(shù);計(jì)費(fèi)條數(shù);計(jì)費(fèi)金額;余額;
示例:
1;發(fā)送成功!;61;0;61;3660;12024380;