短信接口是面向有(yǒu)一定技(jì )術開發能(néng)力的用(yòng)戶而單獨研發的短信(sms)接口。本接口采用(yòng)了通用(yòng)的HTTP形式，可(kě)以支持各種操作(zuò)系統和開發語言，隻要電(diàn)腦能(néng)上網就可(kě)以使用(yòng)發送短信，可(kě)以根據需要開發自己的一套短信平台。也可(kě)以簡單的把短信接口嵌入到您自己的系統中(zhōng)，快速擁有(yǒu)無線(xiàn)應用(yòng)，完善您的服務(wù)！同時提供各種語言的例子代碼。
一、工(gōng)作(zuò)方式
雙方通過HTTP方式交互數據，第三方可(kě)以簡單的“name=value”方式發送提交内容或響應請求内容。即通過HTTP的GET/POST方式交換。
另外雙方需要保證數據傳輸的完整性和安(ān)全性，每次發送請求都有(yǒu)響應(響應返回格式為(wèi)純文(wén)本)，安(ān)全驗證目前采用(yòng)用(yòng)戶名(míng)和密碼的方式。
二、字符編碼
服務(wù)器接收數據可(kě)以是GBK或UTF-8編碼字符,默認接收數據是GBK編碼,如提交的是UTF-8編碼字符,需要添加參數encode=utf8。
請求響應返回内容是GBK編碼。
三、響應格式
所為(wèi)響應即每次向服務(wù)器提交請求後返回值,響應值格式為(wèi)純文(wén)本狀态碼
如發送成功後返回 100
四、短信發送
GET/POST操作(zuò)格式： http://http.c123.com/tx/?uid=賬号&pwd=MD5位32密碼&mobile=号碼&content=内容
接口參數說明 :
| 參數名(míng) | 參數字段 | 參數說明 |
| uid | 用(yòng)戶賬号 | |
| pwd | 用(yòng)戶密碼 | 小(xiǎo)寫32位MD5加密 |
| time | 定時時間 | 可(kě)選項，及時發送時參數無 格式:YYYY-MM-DD HH:MM 如："2010-05-27 12:01" (年-月-日 時:分(fēn)),發送時間以北京時間為(wèi)準 |
| mid | 子擴展号 | 可(kě)選項，根據用(yòng)戶賬号是否支持擴展 |
| encode | 字符編碼 | 可(kě)選項，默認接收數據是GBK編碼,如提交的是UTF-8編碼字符,需要添加參數 encode=utf8 |
| mobile | 接收号碼 |
同時發送給多(duō)個号碼時,号碼之間用(yòng)英文(wén)半角逗号分(fēn)隔(,)如:13972827282,13072827282,02185418874 GET方式每次最多(duō)可(kě)以提交50條号碼 POST方式每次最多(duō)可(kě)以提交2000條号碼[建議用(yòng)POST方式提交] |
| content | 短信内容 |
發送内容需要進行URL字符标準化轉碼。 {URL字符編碼說明:返回字符串，此字符串中(zhōng)除了-_.之外的所有(yǒu)非字母數字字符都将被替換成百分(fēn)号（%）後跟兩位十六進制數，空格則編碼為(wèi)加号（+）} ASP：server.URLEncode("短信内容") PHP：urlencode("短信内容") JAVA：java.net.URLEncoder.encode("短信内容") |
例: 接 收 号：13900008888,13900009999,13100006666,0218882228
發送内容：中(zhōng)國(guó)短信網發送測試
http://http.c123.com/tx/?uid=9999&pwd=fa246d0262c3925617b0c72bb20eeb1d&mobile=13900008888,13900009999,13100006666,0218882228& content=%D6%D0%B9%FA%B6%CC%D0%C5%CD%F8%B7%A2%CB%CD%B2%E2%CA%D4
發成功時,響應狀态碼值: 100
返回發送的狀态碼
狀态碼說明
100 發送成功
101 驗證失敗
102 短信不足
103 操作(zuò)失敗
104 非法字符
105 内容過多(duō)
106 号碼過多(duō)
107 頻率過快
108 号碼内容空
109 賬号凍結
110 禁止頻繁單條發送
111 系統暫定發送
112 号碼錯誤
113 定時時間格式不對
114 賬号被鎖，10分(fēn)鍾後登錄
115 連接失敗
116 禁止接口發送
120 系統升級
五、接收回複短信
操作(zuò)的格式： http://http.c123.com/rx/?uid=用(yòng)戶賬号&pwd=MD5位32密碼
注：提取的回複短信不能(néng)在重複提取，可(kě)以通過time參數重複提取某個時間的所有(yǒu)回複短信，需要間隔10分(fēn)鍾提取一次，不能(néng)頻繁提取。
接口參數說明:
| 參數名(míng) | 參數字段 | 參數說明 |
| uid | 用(yòng)戶賬号 | |
| pwd | 用(yòng)戶密碼 | 小(xiǎo)寫32位MD5加密 |
| time | 取時間段 | 可(kě)選項，可(kě)以取某個小(xiǎo)時回複的内容，内容可(kě)以重複取，格式：(YYYY-MM-DD_HH 如：2008-05-27_14) |
例:http://http.c123.com/rx/?uid=9999&pwd=fa246d0262c3925617b0c72bb20eeb1d
響應結果為(wèi)純文(wén)本,每次可(kě)接收多(duō)條回複信息：
狀态碼{&}回複号碼||回複内容||回複時間||回複網關号{&}回複号碼||回複内容||回複時間||回複網關号…….
例響應結果值:
100{&}13912341234||中(zhōng)國(guó)短信測試回複||2008-05-27 12:10:11||1068112227282{&}15912343333||中(zhōng)國(guó)短信測試回複2||2008-05-27 13:11:11||106811222728200
返回發送的狀态碼
無回複内容時返回空
狀态碼說明
100 代表：接收成功
101 代表： 驗證失敗
六、取剩餘短信條數
操作(zuò)格式： http://http.c123.com/mm/?uid=用(yòng)戶賬号&pwd=MD5位32密碼
接口參數說明 :
| 參數名(míng) | 參數字段 | 參數說明 |
| uid | 用(yòng)戶賬号 | |
| pwd | 用(yòng)戶密碼 | 32位MD5加密 |
例: http://http.c123.com/mm/?uid=9999&pwd=fa246d0262c3925617b0c72bb20eeb1d
響應結果為(wèi)純文(wén)本：
狀态碼||剩餘可(kě)發短信
例響應結果值:
100||22348
七、取已發送總條數
操作(zuò)格式： http://http.c123.com/mm/?uid=用(yòng)戶賬号&pwd=MD5位32密碼&cmd=send
接口參數說明 :
| 參數名(míng) | 參數字段 | 參數說明 |
| uid | 用(yòng)戶賬号 | |
| pwd | 用(yòng)戶密碼 | 32位MD5加密 |
| cmd | send | 取已發送條數 |
例: http://http.c123.com/mm/?uid=9999&pwd=fa246d0262c3925617b0c72bb20eeb1d&cmd=send
響應結果為(wèi)純文(wén)本：
狀态碼||總發短信條數
例響應結果值:
100||22348
狀态碼說明
100 代表：請求成功
101 代表：驗證失敗
