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