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

1、中國短信網(wǎng)中國短信網(wǎng) 短信接口文檔短信接口文檔v2.2v2.2最新修改時(shí)間最新修改時(shí)間:2009-04-08:2009-04-08接口域名：接口域名：一一、工工作作方方式式.1二二、字字符符編編碼碼.2三三、響響應(yīng)應(yīng)格格式式.2四四、短短信信發(fā)發(fā)送送.2五五、接接收收回回復(fù)復(fù)短短信信.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密密 碼碼: :9 9

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

3、短信信發(fā)發(fā)送送GET/POST操作格式： :/tx/?uid=用戶賬號&pwd=MD5位32密碼&mobile=號碼&content=內(nèi)容接口參數(shù)說明:參數(shù)名參數(shù)字段參數(shù)說明uid用戶賬號pwd用戶密碼小寫32位MD5加密time定時(shí)時(shí)間可選項(xiàng)，及時(shí)發(fā)送時(shí)參數(shù)無 格式:YYYY-MM-DD HH:MM如：2021-05-27 12:01 (年-月-日 時(shí):分),發(fā)送時(shí)間以北京時(shí)間為準(zhǔn)mid子擴(kuò)展號可選項(xiàng)，根據(jù)用戶賬號是否支持?jǐn)U展encode字符編碼可選項(xiàng)，默認(rèn)接收數(shù)據(jù)是GBK編碼,如提交的是UTF-8編碼字符,需要添加參數(shù) encode=utf8mobile接收號碼同時(shí)

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

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

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

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

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

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