普通短信發(fā)送
在開發(fā)前,先了解接口發(fā)送短信的操作流程:
1、注冊賬號:用戶接入秒賽科技短信功能,首先需要用戶在秒賽科技官網(wǎng)注冊賬號;
2、身份認(rèn)證:注冊后在用戶中心,完成身份認(rèn)證信息(支持企業(yè)認(rèn)證&個人認(rèn)證);
3、創(chuàng)建簽名:在對應(yīng)的產(chǎn)品欄目的【簽名管理】-新增簽名,審核通過后即可調(diào)用;
4、創(chuàng)建模板:在對應(yīng)的產(chǎn)品欄目的【模板管理】-添加短信模板,審核通過即可調(diào)用(注:接口調(diào)用模板需與審核通過的模板內(nèi)容完全匹配才能發(fā)送);
5、接口對接:開發(fā)調(diào)試過程請查看下方 API文檔 和 demo示例,接入后可使用系統(tǒng)贈送的短信條數(shù)進(jìn)行測試;
6、套餐充值:測試條數(shù)有限,未避免影響正常使用,測試成功后請盡快充值,在短信平臺【我要充值】欄目充值短信套餐。
............................................................................................................................................................................................................................................................................................................................
本文檔主要定了短信平臺對用戶開放的主要接口和定義。
用戶通過HTTP的Get,POST方式提交短信發(fā)送請求。
1.短信提交地址
驗(yàn)證碼通知短信地址
http://139.196.108.241:8080/Api/HttpSendSMYzm.ashx
營銷短信地址
http://139.196.108.241:8080/Api/HttpSendSMYx.ashx
語音驗(yàn)證碼地址
http://139.196.108.241:8080/Api/HttpSendSMVoice.ashx
2.參數(shù)定義
序號 | 參數(shù) | 說明 |
1 | account | 必填參數(shù)。用戶賬號 |
2 | ts | 可選參數(shù),時間戳,格式y(tǒng)yyyMMddHHmmss |
3 | pswd | 必填參數(shù)。用戶密碼,ts參數(shù)為空時填明文密碼,ts參數(shù)不為空時填md5(賬號+密碼+時間戳),對賬號密碼時間戳拼接的字符串進(jìn)行md5加密 |
4 | mobile | 必填參數(shù)。合法的手機(jī)號碼,號碼間用英文逗號分隔。最大50000個號碼 |
5 | msg | 必填參數(shù)。短信內(nèi)容,長度不能超過700個字符。使用URL方式編碼為UTF-8格式。短信內(nèi)容超過70個字符時,會被拆分成多條,然后以長短信的格式發(fā)送。 |
6 | sms_sign | 短信簽名。默認(rèn)不需要傳,需要使用特定簽名時可添加此參數(shù) |
3.短信提交響應(yīng)
用戶短信通過http請求提交到服務(wù)器后,服務(wù)器返回響應(yīng)
(1)返回JSON格式說明
{
"result": 0,
"result_msg": "提交成功",
"msgid": "1670510103017877300",
"ts": "20180510103019"
}
result為響應(yīng)狀態(tài)(0表示成功,其他表示失?。瑀esult_msg 為提示消息,ts為響應(yīng)時間,msgid 為消息id,狀態(tài)匹配使用
(3)響應(yīng)狀態(tài)值說明
代碼 | 說明 |
-1 | 一般錯誤 |
0 | 提交成功 |
101 | 無此用戶 |
102 | 密碼錯 |
103 | 提交過快(提交速度超過流速限制) |
104 | 系統(tǒng)忙(因平臺側(cè)原因,暫時無法處理提交的短信) |
105 | 敏感短信(短信內(nèi)容包含敏感詞) |
106 | 消息長度錯(>700或<=0) |
107 | 包含錯誤的手機(jī)號碼 |
108 | 手機(jī)號碼個數(shù)錯(>50000或<=0) |
109 | 無發(fā)送額度(該用戶可用短信條數(shù)為0) |
110 | 不在發(fā)送時間內(nèi) |
111 | 超出該賬戶當(dāng)月發(fā)送額度限制 |
112 | 無此產(chǎn)品,用戶沒有訂購該產(chǎn)品 |
115 | 自動審核駁回 |
116 | 簽名不合法,未帶簽名(用戶必須帶簽名的前提下) |
117 | IP地址認(rèn)證錯,請求調(diào)用的IP地址不是系統(tǒng)登記的IP地址 |
118 | 用戶沒有相應(yīng)的發(fā)送權(quán)限 |
119 | 用戶已過期 |
120 | 內(nèi)容不在白名單模板中 |
4.注意事項(xiàng)
用戶群發(fā)短信如果有審核的限制,則客戶的短信必須經(jīng)過管理人員的審核,審核通過后才能被提交到行業(yè)網(wǎng)關(guān)進(jìn)行短信實(shí)際發(fā)送。
5.短信發(fā)送例子
驗(yàn)證碼發(fā)送:
http://139.196.108.241:8080/Api/HttpSendSMYzm.ashx?account=xx&pswd=xx&mobile=xx&msg=xx
營銷短信發(fā)送:
http://139.196.108.241:8080/Api/HttpSendSMYx.ashx?account=xx&pswd=xx&mobile=xx&msg=xx
語音驗(yàn)證碼發(fā)送:
http://139.196.108.241:8080/Api/HttpSendSMVoice.ashx?account=xx&pswd=xx&mobile=xx&msg=xx