創藍253雲通訊平臺---簡訊驗證碼介面說明

luck_yun發表於2018-07-12

1 協議說明

名稱

說明

協議

HTTP POST

編碼格式

UTF8

Content-Type

application/json

URL

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賬號

 

創藍253雲通訊平臺---簡訊驗證碼介面說明

1.  傳送的簡訊內容一定要加上簽名,賬號有報備過簽名的可不用帶上簽名, 但如果您有多個簡訊簽名,請將需要的簡訊簽名放在簡訊內容前面
例如您有253雲通訊】【通訊雲】兩個簽名,但是想以【通訊雲】簽名傳送簡訊,則”msg”欄位可賦值為:【通訊雲】你的驗證碼是xxxx”,不填預設第一個簽名。

2.   

使用者自定義擴充套件碼,傳送簡訊顯示號碼,規則為:10690+xxx(通道號)+xxx(系統擴充套件碼) +xxx(使用者自定義擴充套件碼);擴充套件碼的長度將直接影響簡訊上行接收的接收。如需要傳擴充套件碼引數時,請諮詢客服相關設定問題

 

3 應答包體

{    

 "code" : "0"//狀態碼    

 "msgId" : "17041010383624511"//訊息Id    

 "errorMsg" : ""//失敗狀態碼說明(成功返回空)    

 "time" : "20170410103836" //響應時間    

 }

 

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

 


來自 “ ITPUB部落格 ” ,連結:http://blog.itpub.net/31510215/viewspace-2157764/,如需轉載,請註明出處,否則將追究法律責任。

相關文章