1協議說明json
名稱app |
說明ui |
協議編碼 |
HTTP POSTspa |
編碼格式code |
UTF8接口 |
Content-Typeci |
application/json字符串 |
URLio |
http://xxx/msg/send/json 或者 https://xxx/msg/send/json |
接口說明 |
此接口一次可提交不超過1000個手機號碼。 |
2 請求包體
包體爲json字符串,參數以下:
{
"account" : "N6000001", //用戶在253雲通信平臺上申請的API帳號
"password" : "123456", //用戶在253雲通信平臺上申請的API帳號對應的API密鑰
"msg" : "【253】您的驗證碼是:2530", //短信內容。長度不能超過536個字符
"phone" : "15800000000", //手機號碼。多個手機號碼使用英文逗號分隔
"sendtime" : "201704101400", //定時發送短信時間。格式爲yyyyMMddHHmm,值小於或等於當前時間則當即發送,不填則默認爲當即發送(選填參數)
"report" : "true", //是否須要狀態報告(默認爲false)(選填參數)
"extend" : "555", //用戶自定義擴展碼,純數字,建議1-3位(選填參數)
"uid" : "批次編號-場景名(英文或者拼音)" //自助通系統內使用UID判斷短信使用的場景類型,可重複使用,可自定義場景名稱,示例如 VerificationCode(選填參數)
}
注:發送短信的帳號不是253平臺登陸帳號,是短信接口API帳號 。
用戶自定義擴展碼,發送短信顯示號碼,規則爲:10690+xxx(通道號)+xxx(系統擴展碼) +xxx(用戶自定義擴展碼);擴展碼的長度將直接影響短信上行接收的接收。如須要傳擴展碼參數時,請諮詢客服相關設置問題 。
3應答包體
{
"code" : "0", //狀態碼
"msgId" : "17041010383624511", //消息Id
"errorMsg" : "", //失敗狀態碼說明(成功返回空)
"time" : "20170410103836" //響應時間
}
注:code爲響應狀態碼,能夠和「響應狀態碼」進入對比