1.1 短信接口分類
1、用戶自寫(xiě)短信內(nèi)容發(fā)送短信，適合：會(huì)員群發(fā)通知、會(huì)員營(yíng)銷群發(fā)等，有人工審核 ；
2、通過(guò)綁定短信模板發(fā)送短信，適合：驗(yàn)證碼、訂單短信等觸發(fā)類短信，可以免審下發(fā) ；
3、獲取手機(jī)用戶的短信上行。
1.2 短信接口主要功能
短信接口支持中國(guó)移動(dòng)、中國(guó)聯(lián)通、中國(guó)電信以及國(guó)內(nèi)虛擬運(yùn)營(yíng)商所屬的全國(guó)手機(jī)號(hào)碼。國(guó)外手機(jī)可轉(zhuǎn)至國(guó)際短信查看詳情。
1.3 短信接口支持手機(jī)號(hào)碼情況
√ 用戶自寫(xiě)短信內(nèi)容，適合：會(huì)員群發(fā)通知、 會(huì)員營(yíng)銷群發(fā) 等；
√ 單發(fā)或群發(fā)；
√ 支持行業(yè)及廣告營(yíng)銷類內(nèi)容；
√ 支持定時(shí)發(fā)送短信；
√ 小規(guī)模數(shù)量免審自動(dòng)下發(fā)。
√ 無(wú)人工審核 。
1.4 短信接口請(qǐng)求方式
用戶通過(guò)HTTP的POST方式提交短信發(fā)送請(qǐng)求。編碼采用UTF-8編碼。
1.5 短信提交地址
| 環(huán)境 | HTTP請(qǐng)求地址 |
|---|---|
| 正式環(huán)境 | 聯(lián)系客服獲取接口請(qǐng)求地址 |
1.6 參數(shù)定義
| 序號(hào) | 參數(shù) | 說(shuō)明 |
|---|---|---|
| 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)隔開(kāi) |
| 5 | stime | 可選參數(shù)。（發(fā)送時(shí)間，填寫(xiě)時(shí)已填寫(xiě)的時(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)碼和對(duì)應(yīng)的簽名報(bào)給客服） |
1.7 短信提交響應(yīng)
用戶短信通過(guò)http請(qǐng)求提交到服務(wù)器后，服務(wù)器返回響應(yīng)碼，響應(yīng)碼的格式如下：code,sendid,invalidcount,successcount,blackcount,msg
1.7.1格式說(shuō)明
短信提交響應(yīng)為英文逗號(hào)隔開(kāi)的一行數(shù)據(jù)，狀態(tài),發(fā)送編號(hào),無(wú)效號(hào)碼數(shù),成功提交數(shù),黑名單數(shù)和消息，無(wú)論發(fā)送的號(hào)碼是多少，一個(gè)發(fā)送請(qǐng)求只返回一個(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)值說(shuō)明
| 代碼 | 說(shuō)明 |
|---|---|
| 0 | 提交成功 |
| 1 | 含有敏感詞匯 |
| 2 | 含有敏感詞匯 |
| 3 | 沒(méi)有號(hào)碼 |
| 4 | 包含sql語(yǔ)句 |
| 10 | 賬號(hào)不存在 |
| 11 | 賬號(hào)注銷 |
| 12 | 賬號(hào)停用 |
| 13 | IP鑒權(quán)失敗 |
| 14 | 格式錯(cuò)誤 |
| -1 | 系統(tǒng)異常 |
文章均為思樂(lè)科技專注網(wǎng)站建設(shè)，成都網(wǎng)站建設(shè)的成都網(wǎng)站建設(shè)公司原創(chuàng)，轉(zhuǎn)載請(qǐng)注明來(lái)自http://www.stellarxo.com/news/fuwudayi/2017119/77489.html