普通短信發送
在開發前,先了解接口發送短信的操作流程:
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