1. 程式人生 > >創藍253雲通訊短信平臺變量說明

創藍253雲通訊短信平臺變量說明

兩個 超過 tno 模板 三個參數 過濾 請求 acc 一個

253雲通訊變量說明文檔
1 變量短信發送
用戶通過HTTP的POST方式提交短信發送請求。
1.1 系統提交URL地址
http://sms.253.com/msg/HttpVarSM
1.2 參數定義
序號 參數 說明
1 account 用戶賬號
2 pswd 用戶密碼
3 msg 短信模板。其中的變量用“{$var}”來替代。例如:
“{$var},你好!,請你於{$var}日參加活動”,該短信中具有兩個變量參數。編碼為UTF-8格式。最多支持20個{$var}
4 params 變量短信的參數組。單次提交參數組的數目不能超過1000個。編碼為UTF-8格式
每一組參數之間用英文“;”間隔
每一組參數內部用英文“,”間隔,其中第一個參數為手機號碼,第二個參數為模板中第一個變量,第三個參數為模板中第二個變量,以此類推。
例如:
13800210000,李先生,2013-01-01;13500210000,王先生,2013-01-15
表明提交了兩個變量組,其中手機號碼分別為:13800210000和13500210000。模板變量分別為:李先生,2013-01-01和王先生,2013-01-15

格式不符的參數,系統自動過濾掉。
5 needstatus 是否需要狀態報告,取值true或false,true,表明需要狀態報告;false不需要狀態報告
6 extno 可選參數,擴展碼,用戶定義擴展碼,3位,實際提交限制為6位,建議用戶擴展3位

1.3 提交響應
1.3.1 提交成功

響應時間為20110725160412,響應狀態為0 表明那個成功提交到服務器,參數組個數為10表明提交參數params中格式正確的條數為10條, 發送包失敗個數為1表明提交參數msg中格式錯誤的條數為1條;1234567890100為返回的msgid,這個供狀態報告匹配時使用。

1.3.2 提交失敗

本示例表明用戶提交失敗,返回錯誤碼為101,服務器端並未返回msgid。
1.3.3 響應狀態值說明
響應的值在1.2.3的基礎上增加:
代碼 說明
114 可用參數組個數錯誤(小於最小設定值或者大於1000);變量參數組大於20個

1.4 示例
http://sms.253.com/msg/HttpVarSM?account=111111&pswd=123456&msg={$var},你好!,請你於{$var}日參加活動¶ms=13800210000,李先生,2013-01-01;13500210000,王先生,2013-01-15&needstatus=true

創藍253雲通訊短信平臺變量說明