1.1 短信接口分類
1、用戶自寫短信內(nèi)容發(fā)送短信,適合:會(huì)員群發(fā)通知、會(huì)員營銷群發(fā)等,有人工審核 ;
2、通過綁定短信模板發(fā)送短信,適合:驗(yàn)證碼、訂單短信等觸發(fā)類短信,可以免審下發(fā) ;
3、獲取手機(jī)用戶的短信上行。
1.2 短信接口主要功能
短信接口支持中國移動(dòng)、中國聯(lián)通、中國電信以及國內(nèi)虛擬運(yùn)營商所屬的全國手機(jī)號(hào)碼。國外手機(jī)可轉(zhuǎn)至國際短信查看詳情。
1.3 短信接口支持手機(jī)號(hào)碼情況
√ 用戶自寫短信內(nèi)容,適合:會(huì)員群發(fā)通知、 會(huì)員營銷群發(fā) 等;
√ 單發(fā)或群發(fā);
√ 支持行業(yè)及廣告營銷類內(nèi)容;
√ 支持定時(shí)發(fā)送短信;
√ 小規(guī)模數(shù)量免審自動(dòng)下發(fā)。
√ 無人工審核 。
1.4 短信接口請求方式
用戶通過HTTP的POST方式提交短信發(fā)送請求。編碼采用UTF-8編碼。
1.5 短信提交地址
環(huán)境 | HTTP請求地址 |
---|---|
正式環(huán)境 | 聯(lián)系客服獲取接口請求地址 |
1.6 參數(shù)定義
序號(hào) | 參數(shù) | 說明 |
---|---|---|
1 | name | 必填參數(shù)。用戶賬號(hào) |
2 | pwd | 必填參數(shù)。(登陸web平臺(tái):基本資料中的接口密碼) |
3 | content | 必填參數(shù)。發(fā)送內(nèi)容(1-500 個(gè)漢字,建議300字符內(nèi))UTF-8編碼 |
4 | mobile | 必填參數(shù)。手機(jī)號(hào)碼。多個(gè)以英文逗號(hào)隔開 |
5 | stime | 可選參數(shù)。(發(fā)送時(shí)間,填寫時(shí)已填寫的時(shí)間發(fā)送,不填時(shí)為當(dāng)前時(shí)間發(fā)送,秒到) |
6 | sign | 必填參數(shù)。用戶簽名。(建議聯(lián)系銷售進(jìn)行后臺(tái)綁定) |
7 | type | 必填參數(shù)。固定值 pt |
8 | extno | 可選參數(shù),(擴(kuò)展碼,用戶定義擴(kuò)展碼,只能為數(shù)字,如需要擴(kuò)展不同簽名,需要幫擴(kuò)展的號(hào)碼和對應(yīng)的簽名報(bào)給客服) |
1.7 短信提交響應(yīng)
用戶短信通過http請求提交到服務(wù)器后,服務(wù)器返回響應(yīng)碼,響應(yīng)碼的格式如下:code,sendid,invalidcount,successcount,blackcount,msg
1.7.1格式說明
短信提交響應(yīng)為英文逗號(hào)隔開的一行數(shù)據(jù),狀態(tài),發(fā)送編號(hào),無效號(hào)碼數(shù),成功提交數(shù),黑名單數(shù)和消息,無論發(fā)送的號(hào)碼是多少,一個(gè)發(fā)送請求只返回一個(gè)sendid,如果響應(yīng)的狀態(tài)不是"0",則只有狀態(tài)和消息。
1.7.2示例
提交成功
0, 20140821110353234137876543,0,500,0,提交成功
20140821110353234137876543為返回的sendid,這個(gè)狀態(tài)供報(bào)告匹配時(shí)使用。
1.7.3 響應(yīng)狀態(tài)值說明
代碼 | 說明 |
---|---|
0 | 提交成功 |
1 | 含有敏感詞匯 |
2 | 含有敏感詞匯 |
3 | 沒有號(hào)碼 |
4 | 包含sql語句 |
10 | 賬號(hào)不存在 |
11 | 賬號(hào)注銷 |
12 | 賬號(hào)停用 |
13 | IP鑒權(quán)失敗 |
14 | 格式錯(cuò)誤 |
-1 | 系統(tǒng)異常 |
文章均為思樂科技專注網(wǎng)站建設(shè),成都網(wǎng)站建設(shè)的成都網(wǎng)站建設(shè)公司原創(chuàng),轉(zhuǎn)載請注明來自http://www.hcw208.com/news/fuwudayi/2017119/77489.html