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