短信提交接口說(shuō)明文檔.doc

短信通 短信接口V2014.11.11常見(jiàn)問(wèn)題：(接口調(diào)用規(guī)則第2頁(yè)）1問(wèn)：“短信長(zhǎng)度”如何收費(fèi)？70字符1條收費(fèi)，超70字，按65/條，多條收費(fèi)。(通道行業(yè)標(biāo)準(zhǔn)，部分通道67字符單條）2問(wèn)：“短信模板”是什么？短信模板如：您的訂單編碼：【變量】。如需幫助請(qǐng)聯(lián)系客服。 實(shí)際短信：您的訂單編碼：888888。如需幫助請(qǐng)聯(lián)系客服。其中的【變量】= 888888“【變量】”部分可變動(dòng)，其余文字格式必須和“短信模板”完全一致，才可下發(fā)！包括空格、標(biāo)點(diǎn)符號(hào)等。3問(wèn)：“短信簽名”是什么？短信簽名是短信末尾或前面跟的品牌簽名如：您的訂單編碼：888888。如需幫助請(qǐng)聯(lián)系客服?！緯?huì)員驗(yàn)證通知】 短信簽名 = 會(huì)員驗(yàn)證通知（一般是公司或產(chǎn)品簡(jiǎn)稱(chēng)）4問(wèn)：是否支持自定義“短信簽名”和自定義“短信模板”？由于短信行業(yè)受運(yùn)營(yíng)商政策管制，只有政策允許且你的帳號(hào)級(jí)別夠的時(shí)候，才支持。若帳號(hào)無(wú)權(quán)限或系統(tǒng)未開(kāi)放時(shí)，只能選用系統(tǒng)默認(rèn)的通用性短信簽名和短信模版。如果都支持，編輯好簽名、模板，后臺(tái)提交，我們報(bào)備運(yùn)營(yíng)商，審批下來(lái)后就可以按貴公司的格式進(jìn)行發(fā)送了。（以后臺(tái)通告為準(zhǔn)）提交時(shí)，簽名不用加“【】”號(hào)，模板中屬于變量的地方用“【變量】”代替，否則系統(tǒng)識(shí)別不出來(lái)。小批量應(yīng)用【部分自定義內(nèi)容和簽名】實(shí)現(xiàn)方法：短信模板：您的訂單編碼：【變量】。如需幫助請(qǐng)聯(lián)系客服。實(shí)際內(nèi)容：您的訂單編碼：20140208 客服熱線(xiàn)4006668280【速度網(wǎng)絡(luò)】。如需幫助請(qǐng)聯(lián)系客服?！緯?huì)員驗(yàn)證通知】可以把訂單編碼、客服熱線(xiàn)、【店鋪名稱(chēng)】，都融入到 一個(gè)【變量】里。短信模板：您的訂單編碼：【變量】。如需幫助請(qǐng)聯(lián)系客服。實(shí)際內(nèi)容：您的訂單編碼：8888【速度網(wǎng)絡(luò)】。如需幫助請(qǐng)聯(lián)系客服?！緯?huì)員驗(yàn)證通知】可以把驗(yàn)證碼、網(wǎng)站或軟件名稱(chēng)，都融入到 一個(gè)【變量】里。5問(wèn)：我可以綁定IP嗎？為了避免各種原因的帳號(hào)盜用情況，造成貴公司短信被濫用，所以我們的系統(tǒng)有ip驗(yàn)證功能，只發(fā)送您這邊認(rèn)可的ip地址提交的短信。6問(wèn)：接口調(diào)試返回“104 內(nèi)容未審核”錯(cuò)誤？發(fā)送內(nèi)容未按系統(tǒng)模板或備案的模板下發(fā) 或 程序編碼gbk、utf-8和接口不一致短信通 HTTP接口文檔一、工作方式雙方通過(guò)HTTP方式交互數(shù)據(jù)，第三方可以簡(jiǎn)單的“name=value”方式發(fā)送提交內(nèi)容或響應(yīng)請(qǐng)求內(nèi)容。即通過(guò)HTTP的GET/POST方式交換。另外雙方需要保證數(shù)據(jù)傳輸?shù)耐暾院桶踩?，每次發(fā)送請(qǐng)求都有響應(yīng)(響應(yīng)返回格式為純文本)，安全驗(yàn)證目前采用用戶(hù)名和密碼的方式。二、字符編碼不同的編碼方式請(qǐng)使用不同的接口地址三、國(guó)內(nèi)觸發(fā)類(lèi)短信接口|驗(yàn)證碼/訂單提醒*非群發(fā)類(lèi)！（國(guó)內(nèi)群發(fā)類(lèi)是“五”）GET/POST操作格式，URL調(diào)試專(zhuān)用模版：GBK編碼發(fā)送接口地址/gbk/sms.aspx?account=用戶(hù)賬號(hào)&password=接口密碼&mobile=號(hào)碼&content=您的訂單編碼：888888。如需幫助請(qǐng)聯(lián)系客服。UTF-8編碼發(fā)送接口地址/utf8/sms.aspx?account=用戶(hù)賬號(hào)&password=接口密碼&mobile=號(hào)碼&content=您的訂單編碼：888888。如需幫助請(qǐng)聯(lián)系客服。*特別注意：小批量調(diào)試或應(yīng)用訂購(gòu) 短信內(nèi)容只能用“系統(tǒng)公共模版”相對(duì)固定格式，否則會(huì)報(bào)錯(cuò)104“內(nèi)容未審核”。短信內(nèi)容模版：您的訂單編碼：【變量】。如需幫助請(qǐng)聯(lián)系客服。實(shí)際短信內(nèi)容：您的訂單編碼：888888。如需幫助請(qǐng)聯(lián)系客服。其中【變量】是可以自定義內(nèi)容，其它都要和模板一致，包括空格、標(biāo)點(diǎn)符號(hào)等！自定義短信模版、簽名 需要審批和備案，年消費(fèi)3-5萬(wàn)條。具體流程請(qǐng)聯(lián)系在線(xiàn)客服。*返回發(fā)送的狀態(tài)碼說(shuō)明：狀態(tài)碼說(shuō)明100發(fā)送成功101驗(yàn)證失敗102手機(jī)號(hào)碼格式不正確103會(huì)員級(jí)別不夠104內(nèi)容未審核105內(nèi)容過(guò)多106賬戶(hù)余額不足107Ip受限108手機(jī)號(hào)碼發(fā)送太頻繁，請(qǐng)換號(hào)或隔天再發(fā)109帳號(hào)被鎖定110手機(jī)號(hào)發(fā)送頻率持續(xù)過(guò)高，黑名單屏蔽數(shù)日120系統(tǒng)升級(jí)接口參數(shù)說(shuō)明:參數(shù)名參數(shù)字段參數(shù)說(shuō)明account用戶(hù)賬號(hào)注冊(cè)時(shí)的用戶(hù)名password接口密碼注意！非帳號(hào)登錄密碼！管理后臺(tái)“接口設(shè)置”里設(shè)置。mobile接收號(hào)碼注意！1個(gè)號(hào)碼接收頻率5次/天。不然易引起運(yùn)營(yíng)商網(wǎng)關(guān)屏蔽數(shù)天。果大量調(diào)試，多個(gè)手機(jī)號(hào)碼輪換調(diào)試。如果需要更高頻率聯(lián)系客服申請(qǐng)。content短信內(nèi)容發(fā)送內(nèi)容需要進(jìn)行URL字符標(biāo)準(zhǔn)化轉(zhuǎn)碼。URL字符編碼說(shuō)明:返回字符串，此字符串中除了-_.之外的所有非字母數(shù)字字符都將被替換成百分號(hào)（%）后跟兩位十六進(jìn)制數(shù)，空格則編碼為加號(hào)（+）ASP：server.URLEncode(短信內(nèi)容)PHP：urlencode(短信內(nèi)容)JAVA：.URLEncoder.encode(短信內(nèi)容)專(zhuān)用調(diào)試模版：您的訂單編碼：888888。如需幫助請(qǐng)聯(lián)系客服。例: 接 收 號(hào)ET/POST操作格式，URL調(diào)試專(zhuān)用模版：/utf8/sms.aspx?account=9999&password=接口密碼&mobilecontent=您的訂單編碼：888888。如需幫助請(qǐng)聯(lián)系客服。發(fā)成功時(shí)響應(yīng)狀態(tài)碼值: 100*特別注意：小批量調(diào)試或應(yīng)用訂購(gòu) 短信內(nèi)容只能用“系統(tǒng)公共模版”相對(duì)固定格式，否則會(huì)報(bào)錯(cuò)104“內(nèi)容未審核”。短信內(nèi)容模版：您的訂單編碼：【變量】。如需幫助請(qǐng)聯(lián)系客服。實(shí)際短信內(nèi)容：您的訂單編碼：888888。如需幫助請(qǐng)聯(lián)系客服。其中【變量】是可以自定義內(nèi)容，其它都要和模板一致，包括空格、標(biāo)點(diǎn)符號(hào)等！自定義短信模版、簽名 需要審批和備案，年消費(fèi)3-5萬(wàn)條。具體流程請(qǐng)聯(lián)系在線(xiàn)客服。*四、*國(guó)際短信接口*非國(guó)內(nèi)?。▏?guó)內(nèi)觸發(fā)是“三”群發(fā)“五”）GET/POST操作格式：GBK編碼發(fā)送接口地址：/gbk/worldapi.aspx?account=用戶(hù)賬號(hào)&password=接口密碼&mobile=號(hào)碼&content=內(nèi)容UTF-8編碼發(fā)送接口地址：/utf8/worldapi.aspx?account=用戶(hù)賬號(hào)&password=接口密碼&mobile=號(hào)碼&content=內(nèi)容未充值用戶(hù) 調(diào)試專(zhuān)用 內(nèi)容 模板：內(nèi)容 = 尊敬的用戶(hù)您已經(jīng)注冊(cè)成功，用戶(hù)名：0 密碼：1 感謝您的注冊(cè)！備注： 0=帳號(hào)用戶(hù)名，1=帳號(hào)密碼（無(wú)需中括弧） 必須是真實(shí)注冊(cè)信息，否則會(huì)返回104錯(cuò)誤。返回發(fā)送的狀態(tài)碼說(shuō)明：狀態(tài)碼說(shuō)明100發(fā)送成功101驗(yàn)證失敗102手機(jī)號(hào)碼格式不正確103會(huì)員級(jí)別不夠104內(nèi)容未審核105內(nèi)容過(guò)多106賬戶(hù)余額不足107Ip受限108手機(jī)號(hào)碼發(fā)送太頻繁，請(qǐng)換號(hào)或隔天再發(fā)109帳號(hào)被鎖定110發(fā)送通道不正確111當(dāng)前時(shí)間段禁止短信發(fā)送120系統(tǒng)升級(jí)接口參數(shù)說(shuō)明:參數(shù)名參數(shù)字段參數(shù)說(shuō)明account用戶(hù)賬號(hào)注冊(cè)時(shí)的用戶(hù)名password接口密碼注意！非帳號(hào)登錄密碼！管理后臺(tái)“接口設(shè)置”里設(shè)置。mobile接收號(hào)碼手機(jī)號(hào)碼，如多個(gè)以英文逗號(hào)分隔（建議100個(gè)及以?xún)?nèi)的手機(jī)號(hào)碼，,超過(guò)系統(tǒng)上限將會(huì)返回參數(shù)錯(cuò)誤）。 如:德國(guó)手機(jī)舉例：國(guó)際區(qū)碼：49地區(qū)區(qū)碼：0179手機(jī)號(hào)碼：1234567 填寫(xiě)的正確格式為：491791234567 注意！地區(qū)城市區(qū)碼的0或00不用加content短信內(nèi)容發(fā)送內(nèi)容需要進(jìn)行URL字符標(biāo)準(zhǔn)化轉(zhuǎn)碼。URL字符編碼說(shuō)明:返回字符串，此字符串中除了-_.之外的所有非字母數(shù)字字符都將被替換成百分號(hào)（%）后跟兩位十六進(jìn)制數(shù)，空格則編碼為加號(hào)（+）ASP：server.URLEncode(短信內(nèi)容)PHP：urlencode(短信內(nèi)容)JAVA：.URLEncoder.encode(短信內(nèi)容)調(diào)試專(zhuān)用模版(未充值用戶(hù))：/utf8/worldapi.aspx?account=9999&password=接口密碼&mobile=手機(jī)號(hào)碼&content=尊敬的用戶(hù)您已經(jīng)注冊(cè)成功，用戶(hù)名：0 密碼：1 感謝您的注冊(cè)！未充值用戶(hù) 調(diào)試專(zhuān)用 內(nèi)容 模板：內(nèi)容 = 尊敬的用戶(hù)您已經(jīng)注冊(cè)成功，用戶(hù)名：0 密碼：1 感謝您的注冊(cè)！備注： 0=帳號(hào)用戶(hù)名，1=帳號(hào)密碼（無(wú)需中括?。?必須是真實(shí)注冊(cè)信息，否則會(huì)返回104錯(cuò)誤。有充值記錄帳號(hào)，即可自定義短信內(nèi)容。發(fā)成功時(shí)響應(yīng)狀態(tài)碼值: 100五、國(guó)內(nèi)群發(fā)類(lèi)短信接口?。ú恢С謫螚l頻繁提交）*非觸發(fā)類(lèi)！（驗(yàn)證碼、訂單等是“三”）GET/POST操作格式：GBK編碼發(fā)送接口地址/gbk/openapi.aspx?account=用戶(hù)賬號(hào)&password=接口密碼&mobile=號(hào)碼&content=內(nèi)容UTF-8編碼發(fā)送接口地址/utf8/openapi.aspx?account=用戶(hù)賬號(hào)&password=接口密碼&mobile=號(hào)碼&content=內(nèi)容未充值用戶(hù) 調(diào)試專(zhuān)用 內(nèi)容 模板：內(nèi)容 = 尊敬的用戶(hù)您已經(jīng)注冊(cè)成功，用戶(hù)名：0 密碼：1 感謝您的注冊(cè)！備注： 0=帳號(hào)用戶(hù)名，1=帳號(hào)密碼（無(wú)需中括弧） 必須是真實(shí)注冊(cè)信息，否則會(huì)返回104錯(cuò)誤。返回發(fā)送的狀態(tài)碼說(shuō)明：狀態(tài)碼說(shuō)明100發(fā)送成功101驗(yàn)證失敗102手機(jī)號(hào)碼格式不正確103會(huì)員級(jí)別不夠104內(nèi)容未審核105內(nèi)容過(guò)多106賬戶(hù)余額不足107Ip受限108手機(jī)號(hào)碼發(fā)送太頻繁，請(qǐng)換號(hào)或隔天再發(fā)109帳號(hào)被鎖定110發(fā)送通道不正確111當(dāng)前時(shí)間段禁止短信發(fā)送120系統(tǒng)升級(jí)接口參數(shù)說(shuō)明:參數(shù)名參數(shù)字段參數(shù)說(shuō)明account用戶(hù)賬號(hào)注冊(cè)時(shí)的用戶(hù)名password接口密碼注意！非帳號(hào)登錄密碼！管理后臺(tái)“接口設(shè)置”里設(shè)置。mobile接收號(hào)碼手機(jī)號(hào)碼，如多個(gè)以英文逗號(hào)分隔（建議1000個(gè)及以?xún)?nèi)的手機(jī)號(hào)碼，,超過(guò)系統(tǒng)上限將會(huì)返回參數(shù)錯(cuò)誤）。 如:content短信內(nèi)容發(fā)送內(nèi)容需要進(jìn)行URL字符標(biāo)準(zhǔn)化轉(zhuǎn)碼。URL字符編碼說(shuō)明:返回字符串，此字符串中除了-_.之外的所有非字母數(shù)字字符都將被替換成百分號(hào)（%）后跟兩位十六進(jìn)制數(shù)，空格則編碼為加號(hào)（+）ASP：server.URLEncode(短信內(nèi)容)PHP：urlencode(短信內(nèi)容)JAVA：.URLEncoder.encode(短信內(nèi)容)例: 接 收 號(hào)RL調(diào)試專(zhuān)用模版(未充值用戶(hù))：/utf8/sms.aspx?account=9999&password=接口密碼&mobilecontent=尊敬的用戶(hù)您已經(jīng)注冊(cè)成功，用戶(hù)名：0 密碼：1 感謝您的注冊(cè)！未充值用戶(hù) 調(diào)試專(zhuān)用 內(nèi)容 模板：內(nèi)容 = 尊敬的用戶(hù)您已經(jīng)注冊(cè)成功，用戶(hù)名：0 密碼：1 感謝您的注冊(cè)！備注： 0=帳號(hào)用戶(hù)名，1=帳號(hào)密碼（無(wú)需中括?。?必須是真實(shí)注冊(cè)信息，否則會(huì)返回104錯(cuò)誤。有充值記錄帳號(hào)，即可自定義短信內(nèi)容。