中國短信網(wǎng)http接口文檔

1、中國短信網(wǎng)中國短信網(wǎng)HTTPHTTP短信接口文檔短信接口文檔v2.2v2.2最新修改時間最新修改時間:2009-04-08:2009-04-08接口域名：接口域名：一一、工工作作方方式式.1二二、字字符符編編碼碼.2三三、響響應應格格式式.2四四、短短信信發(fā)發(fā)送送.2五五、接接收收回回復復短短信信.3六六、取取剩剩余余短短信信條條數(shù)數(shù) .4七七、取取已已發(fā)發(fā)送送總總條條數(shù)數(shù) .5八八、密密碼碼修修改改.5九九、接接口口安安全全（綁綁定定 I IP P）.6十十、狀狀態(tài)態(tài)碼碼說說明明 .6十十一一、程程序序示示例例下下載載 .7測測 試試 賬賬 號號用用戶戶名名: :9 99 99 99 9密密

2、 碼碼: :9 99 99 99 9一一、工工作作方方式式雙方通過HTTP方式交互數(shù)據(jù)，第三方可以簡單的“name=value”方式發(fā)送提交內容或響應請求內容。即通過HTTP的GET/POST方式交換。另外雙方需要保證數(shù)據(jù)傳輸?shù)耐暾院桶踩?，每次發(fā)送請求都有響應(響應返回格式為純文本)，安全驗證目前采用用戶名和密碼的方式。二二、字字符符編編碼碼服務器接收數(shù)據(jù)可以是GBK或UTF-8編碼字符,默認接收數(shù)據(jù)是GBK編碼,如提交的是UTF-8編碼字符,需要添加參數(shù)encode=utf8。請求響應返回內容是GBK編碼。三三、響響應應格格式式所為響應即每次向服務器提交請求后返回值響應值格式為純文本狀態(tài)

3、碼如發(fā)送成功后返回100四四、短短信信發(fā)發(fā)送送GET/POST操作格式：/?uid=用戶賬號&pwd=MD5位32密碼&mobile=號碼&content=內容接口參數(shù)說明:參數(shù)名參數(shù)字段參數(shù)說明uid用戶賬號pwd用戶密碼小寫32位MD5加密time定時時間可選項，及時發(fā)送時參數(shù)無 格式:YYYY-MM-DD HH:MM如：2010-05-27 12:01 (年-月-日 時:分),發(fā)送時間以北京時間為準mid子擴展號可選項，根據(jù)用戶賬號是否支持擴展encode字符編碼可選項，默認接收數(shù)據(jù)是GBK編碼,如提交的是UTF-8編碼字符,需要添加參數(shù) encode=utf8m

4、obile接收號碼同時發(fā)送給多個號碼時,號碼之間用英文半角逗號分隔(,)如:,G GE ET T 方式每次最多可以提交50條號碼P PO OS ST T方式每次最多可以提交2000條號碼建議用POST方式提交content短信內容發(fā)送內容需要進行URL字符標準化轉碼。URL字符編碼說明:返回字符串，此字符串中除了-_.之外的所有非字母數(shù)字字符都將被替換成百分號（%）后跟兩位十六進制數(shù)，空格則編碼為加號（+）ASP：server.URLEncode(短信內容)PHP：urlencode(短信內容)JAVA：.URLEncoder.encode(短信內容)例例: :接接 收收 1 10 00 00

5、 00 06 66 66 66 6, ,0 02 21 18 88 88 82 22 22 28 8發(fā)發(fā)送送內內容容：中中國國短短信信網(wǎng)網(wǎng)發(fā)發(fā)送送測測試試9999&pwd=fa246d0262c3925617b0c72bb20eeb1d&mobile=&content=%D6%D0%B9%FA%B6%CC%D0%C5%CD%F8%B7%A2%CB%CD%B2%E2%CA%D4發(fā)成功時響應狀態(tài)碼值: 100返回發(fā)送的狀態(tài)碼狀狀態(tài)態(tài)碼碼說說明明100 發(fā)送成功101 驗證失敗102 短信不足103 操作失敗104 非法字符105 內容過多106 號碼過多107 頻率過快10

6、8 號碼內容空109 賬號凍結110 禁止頻繁單條發(fā)送111 系統(tǒng)暫定發(fā)送112 號碼錯誤113 定時時間格式不對114 賬號被鎖，10分鐘后登錄115 連接失敗116 禁止接口發(fā)送117 綁定IP不正確120 系統(tǒng)升級五五、接接收收回回復復短短信信操作的格式：rx/?uid=用戶賬號&pwd=MD5位32密碼注：提取的回復短信不能在重復提取，可以通過time參數(shù)重復提取某個時間的所有回復短信，需要間隔10分鐘提取一次，不能頻繁提取。接口參數(shù)說明:參數(shù)參數(shù)字段名說明uid用戶賬號pwd用戶密碼小寫32位MD5加密time取時間段可選項，可以取某個小時回復的內容，內容可以重復取，格式：(

7、YYYY-MM-DD_HH 如：2008-05-27_14)例例: :rx/?uid=9999&pwd=fa246d0262c3925617b0c72bb20eeb1d 響應結果為純文本,每次可接收多條回復信息：狀態(tài)碼&回復號碼|回復內容|回復時間|回復網(wǎng)關號&回復號碼|回復內容|回復時間|回復網(wǎng)關號.例例響響應應結結果果值值: :無回復內容時返回空狀狀態(tài)態(tài)碼碼說說明明100接收成功101驗證失敗六六、取取剩剩余余短短信信條條數(shù)數(shù)操作格式：mm/?uid=用戶賬號&pwd=MD5位32密碼接口參數(shù)說明:參數(shù)參數(shù)字段名說明uid用戶賬號pwd用戶密碼32位MD5加

8、密例例: :mm/?uid=9999&pwd=fa246d0262c3925617b0c72bb20eeb1d 響應結果為純文本：狀態(tài)碼|剩余可發(fā)短信 例例響響應應結結果果值值: :100|22348七七、取取已已發(fā)發(fā)送送總總條條數(shù)數(shù)操作格式：httmm/?uid=用戶賬號&pwd=MD5位32密碼&cmd=send接口參數(shù)說明:參數(shù)參數(shù)字段名說明uid用戶賬號pwd用戶密碼32位MD5加密cmdsend取已發(fā)送條數(shù)例例: :mm/?uid=9999&pwd=fa246d0262c3925617b0c72bb20eeb1d&cmd=send 響應結果為純

9、文本：狀態(tài)碼|總發(fā)短信條數(shù) 例例響響應應結結果果值值: :100|22348狀狀態(tài)態(tài)碼碼說說明明100請求成功101驗證失敗八八、密密碼碼修修改改操作格式：pw/?uid=用戶賬號&pwd=MD532位密碼&newpwd=新密碼接口參數(shù)說明:參數(shù)參數(shù)字段名說明uid用戶賬號pwd用戶密碼32位MD5加密newpwd新密碼新的密碼，不需要MD5例例: :將將密密碼碼改改成成：1 12 23 31 12 23 3mm/?uid=9999&pwd=fa246d0262c3925617b0c72bb20eeb1d&newpwd=123123響應結果為純文本：狀態(tài)碼例例響響應應結結果果值值: :100狀狀態(tài)態(tài)碼碼說說明明100修改成功101驗證失敗103填寫新密碼九九、接接口口安安全全（綁綁定定I IP P）為了接口安全，請登錄平臺sms.c123 在“系統(tǒng)設置”中綁定你服務器的IP地址，可綁定3個固定IP,綁定IP后只有通過你的服務器來發(fā)送短信，防止他人使用十十、狀狀態(tài)態(tài)碼碼說說明明返回發(fā)送的狀態(tài)碼狀狀態(tài)態(tài)碼碼說說明明100 發(fā)送成功101 驗證失敗102 短信不足103 操作失敗104 非法字符