創藍253雲通訊平臺---短信驗證碼接口說明

1 協議說明
名稱 說明
協議 HTTP POST
編碼格式 UTF8
Content-Type application/json
URL http://xxx/msg/send/json 或者 https://xxx/msg/send/json
完整地址請登錄253雲通訊自助通平臺或者詢問您的商務負責人獲取
接口說明 此接口一次可提交不超過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賬號 。

  1. 發送的短信內容一定要加上簽名,賬號有報備過簽名的可不用帶上簽名, 但如果您有多個短信簽名,請將需要的短信簽名放在短信內容前面 。
    例如您有”【253雲通訊】”,”【通訊雲】”兩個簽名,但是想以”【通訊雲】”簽名發送短信,則”msg”字段可賦值爲:”【通訊雲】你的驗證碼是xxxx”,不填默認第一個簽名。
  2. 用戶自定義擴展碼,發送短信顯示號碼,規則爲:10690+xxx(通道號)+xxx(系統擴展碼) +xxx(用戶自定義擴展碼);擴展碼的長度將直接影響短信上行接收的接收。如需要傳擴展碼參數時,請諮詢客服相關設置問題 。

3 應答包體
{
"code" : "0", //狀態碼
"msgId" : "17041010383624511", //消息Id
"errorMsg" : "", //失敗狀態碼說明(成功返回空)
"time" : "20170410103836" //響應時間
}

注:code爲響應狀態碼,可以和“響應狀態碼”進入對比

發表評論
所有評論
還沒有人評論,想成為第一個評論的人麼? 請在上方評論欄輸入並且點擊發布.
相關文章