z API接口,群發短信公司,群發短信通道-盛世云通訊
首頁 > 技術支撐 > API接口

短信接口說明

l  協議說明

用戶在遵循HTTP協議的前提下,可通過GET和POST方式提交短信發送請求。

短信可以提交不超過10000個手機號碼,每個號碼用英文逗號間隔。

注意:一次提交發送超過200個手機號碼,請使用POST請求

注意:使用POST請求時請將數據放在請求體(body)中

 

l  短信發送請求地址

環境

HTTP請求地址

正式環境

http://ip:18002/send.do

 

注意:接入之后最好向管理員申請ip地址綁定,這樣能防止被惡意嘗試造成賬號泄露或被鎖定;(密碼連續錯誤10次將被鎖定)

注意:header中的Content-Type必須為application/x-www-form-urlencoded  !!!

 

l  短信發送請求參數

參數

是否必填

描述

uid

必填

用戶ID

pw

必填

pw值為md5(用戶密碼+tm)。(注:中間的+號在實際賦值時不要填寫)

mb

必填

目的手機號,多條請用英文逗號隔開,最多10000個號碼  

ms

必填

發送內容,請用utf8方式進行編碼,最多1000個文字(1個英文或數字也算1個文字)

tm

必填

當前時間,格式:yyyyMMddHHmmss,共14位,tm設置為當前時間,與標準時間誤差不能超過10分鐘。

dm

選填

定時時間,格式:yyyyMMddHHmmss

ex

選填

發送擴展號,對于可擴展的通道,可以根據需要任意擴展,但發送出去總長度不會超過20位。

舉例:http://ip:18002/send.do?uid=7592&pw=md5(密碼+tm)&mb=13900000001&ms=測試【測試】&tm=20190729141735

 

l  短信發送響應返回值

返回值

描述

批次號 或 0,批次號

發送成功,批次號(例如1112090856000110或0,1112090856000110)

-1

uid或密碼為空

-2

下發號碼為空

-3

下發內容為空

-4

內容超長

-5

下發號碼超長

-6

uid或密碼不正確

-7

余額不足

-8

ip鑒權未通過

-9

協議類型不對

-99

系統異常

l  接收狀態報告格式(POST)

 

參數

描述

data

內容為id,mb,st|id,mb,st|id,mb,st(id,mb,st為一條,多條用|分割)

注意:接收狀態報告的地址由接入方提供,通道方把狀態報告(批次號、手機號碼、狀態)的數據傳給此地址

 

l  短信狀態請求參數(POST)

 

參數

描述

id

批次號

st

短信狀態報告,stat=DELIVRD表示用戶成功接收短信。

mb

手機號碼

舉例:data=1112090856000110,13900000001,DELIVRD|1112090856000111,13900000002,DELIVRD|1112090856000112,13900000003,DELIVRD

 

 

 

 

 

 

l  接收短信上行參數(GET)

 

參數

描述

mb

手機號

sc

特服號

ms

內容(utf8編碼)

注意:由合作方提供的接收上行的地址,通道方把用戶回復的短信數據(手機號、特服號、內容)傳給此地址

 

l  查詢余額請求地址(POST)

環境

HTTP請求地址

正式環境

http://ip:18005/balance.do

 

注意:接入之后最好申請ip地址綁定,這樣能防止被惡意嘗試造成賬號泄露或被鎖

 

l  查詢余額請求參數(GET)

 

參數

描述

uid

用戶ID

pw

pw值為md5(用戶密碼+tm)。(注:中間的+號在實際賦值時不要填寫)

tm

當前時間,格式:yyyyMMddHHmmss,共14位,tm設置為當前時間,與標準時間誤差不能超過10分鐘。

 

l  查詢余額響應返回值(GET)

 

返回值

描述

直接返回余額數字

余額 例如:169082

-1

用戶不存在

-2

錯誤次數太多了

-3

uid或密碼不正確

-4

ip鑒權未通過

-5

錯誤次數太多了

 


首页-汤姆高清影院官网-首页汤姆高清影院官网入口-汤姆影视