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