第一章 移動(dòng)信息管理系統(tǒng)介紹1.1.簡介“移動(dòng)信息管理系統(tǒng)”（以下簡稱短信平臺(tái)）是自主研發(fā)的SMS綜合管理系統(tǒng)，用于實(shí)現(xiàn)企業(yè)終端客戶面向特定會(huì)員用戶進(jìn)行快捷高效短信發(fā)送及查詢管理。本文檔為企業(yè)終端客戶使用API接口，與本系統(tǒng)進(jìn)行對(duì)接而完成。 作為專注于無線增值服務(wù)的SP商，我們堅(jiān)決抵制垃圾短信并嚴(yán)禁將短信資源轉(zhuǎn)租或轉(zhuǎn)售給任何第三方，友情提醒通過我們接口發(fā)送的信息僅限發(fā)給您的最終授權(quán)會(huì)員用戶。我們承諾永不發(fā)展代理商，只為最優(yōu)質(zhì)企業(yè)全心提供最具價(jià)值的資源與服務(wù)！為了確保您的穩(wěn)定高效使用并維護(hù)信息發(fā)送的良好秩序，請(qǐng)您與我們一起努力，感謝您的理解與配合。 1.2.縮略語清單客戶端：本文中特指短信平臺(tái)企業(yè)終端客戶端。 服務(wù)端：本文中特指短信平臺(tái)企業(yè)網(wǎng)關(guān)服務(wù)端。 1.3.修訂時(shí)間2012-11-30 完成基本內(nèi)容。 第二章 API接口說明2.1.（HTTP方式）接口1、普通短信提交地址：http://192.168.0.188:8800/sendSms.do send接口提交方式：GET/POST 功能：發(fā)送短信 短信簽名（重要）：如果用戶發(fā)送的內(nèi)容最后一個(gè)字符為 “】”，默認(rèn)為用戶已經(jīng)增加了簽名，否則自動(dòng)追加用戶在平臺(tái)中設(shè)置的簽名到發(fā)送的內(nèi)容最后。 格式：“【簽名】”，系統(tǒng)自動(dòng)追加的簽名中，會(huì)自動(dòng)增加“【】”，內(nèi)容為用戶設(shè)置的內(nèi)容。 輸入?yún)?shù) | 描述 | 提交url（30分鐘不可重復(fù)提交） | http://192.168.0.188:8800/sendXSms.do | 提交url（可重復(fù)提交） | http://192.168.0.188:8800/sendSms.do | 國際通道地址（加區(qū)號(hào)只支持12位的手機(jī)號(hào)） | http://192.168.0.188:8800/sendGSms.do | username | 用戶名（必填） | password | 密碼（必填MD5加密,小寫） | mobile | 手機(jī)號(hào)，多個(gè)手機(jī)號(hào)為用半角 , 分開，如13899999999,13688888888(最多2000個(gè)，必填) | content | 發(fā)送內(nèi)容（必填） | dstime | 定時(shí)時(shí)間，為空時(shí)表示立即發(fā)送（選填） 格式：20130202120212 | productid | 產(chǎn)品id(必填) | xh | 擴(kuò)展的小號(hào),必須為數(shù)字，沒有請(qǐng)留空 | seed | 絕密（默認(rèn)為空或不帶此參數(shù)，如有值：YYYYMMDD HHMISS，例如：20130806102030） |
樣例： http://192.168.0.188:8800/sendXSms.do?username=haha&password=888888&mobile=13900000000&content=test&dstime=&productid=61341&xh= 其中：content參數(shù)，采用下列方式處理： // String content = "漢字"; // content = URLEncoder.encode(content, "UTF-8"); 返回參數(shù) | 描述 | -1 | 用戶名或者密碼不正確或用戶禁用 | 1,xxxxxxxx | 1代表發(fā)送短信成功,xxxxxxxx代表消息編號(hào) | 0,xxxxxxxx | 0發(fā)送短信失敗,xxxxxxxx代表消息編號(hào) | 2 | 余額不夠或扣費(fèi)錯(cuò)誤 | 3 | 扣費(fèi)失敗異常（請(qǐng)聯(lián)系客服） | 5,xxxxxxxx | 短信定時(shí)成功, xxxxxxxx代表消息編號(hào) | 6 | 有效號(hào)碼為空 | 7 | 短信內(nèi)容為空 | 8 | 無簽名，必須，格式：【簽名】 | 9 | 沒有Url提交權(quán)限 | 10 | 發(fā)送號(hào)碼過多,最多支持2000個(gè)號(hào)碼 | 11 | 產(chǎn)品ID異?；虍a(chǎn)品禁用 | 12 | 參數(shù)異常 | 13 | 30分種重復(fù)提交 | 14 | 用戶名或密碼不正確，產(chǎn)品余額為0，禁止提交，聯(lián)系客服 | 15 | Ip驗(yàn)證失敗 | 19 | 短信內(nèi)容過長，最多支持500個(gè) | 20 | 定時(shí)時(shí)間不正確：格式：20130202120212(14位數(shù)字) |
2、變量短信一般變量提交地址：http://192.168.0.188:8800/sendManySms.do 變量短信打包提交地址：http://192.168.0.188:8800/sendManySmsPack.do(如果一個(gè)連接里所有的內(nèi)容都一樣，則會(huì)自動(dòng)進(jìn)行打包，打包后相當(dāng)于群發(fā)) send接口提交方式：POST（get不支持大數(shù)據(jù)） 功能：發(fā)送短信 短信簽名（重要）：如果用戶發(fā)送的內(nèi)容最后一個(gè)字符為 “】”，默認(rèn)為用戶已經(jīng)增加了簽名，否則自動(dòng)追加用戶在平臺(tái)中設(shè)置的簽名到發(fā)送的內(nèi)容最后。 格式：“【簽名】”，系統(tǒng)自動(dòng)追加的簽名中，會(huì)自動(dòng)增加“【】”，內(nèi)容為用戶設(shè)置的內(nèi)容。變量短信只支持單條多任務(wù)發(fā)送，不支持群發(fā)多任務(wù)發(fā)送 輸入?yún)?shù) | 描述 | username | 用戶名（必填） | password | 密碼（必填MD5加密,小寫） | content | 發(fā)送內(nèi)容多個(gè)內(nèi)容用※分開，如短信1【簽名】※短信2【簽名】（必填） | mobile | 手機(jī)號(hào)，多個(gè)手機(jī)號(hào)為用半角 , 分開，如13899999999,13688888888(最多200個(gè)，必填) | productid | 產(chǎn)品id(必填) | dstime | 定時(shí)時(shí)間，為空時(shí)表示立即發(fā)送（選填） 格式：20130202120212 | xh | 擴(kuò)展的小號(hào),必須為數(shù)字，沒有請(qǐng)留空 |
樣例： http://192.168.0.188:8800/sendManySms.do?username=haha&password=888888&mobile=13900000000,13900000000&content=短信1【簽名】※短信2【簽名】&dstime=&productid=61341&xh= 手機(jī)號(hào)與內(nèi)容的條數(shù)必須相同，否則會(huì)發(fā)送失敗。 其中：content參數(shù)，采用下列方式處理： // String content = "漢字"; // content = URLEncoder.encode(content, "UTF-8"); 返回參數(shù) | 描述 | -1 | 用戶名或者密碼不正確 | 1,xxxxxxxx | 1代表發(fā)送短信成功,xxxxxxxx代表消息編號(hào) | 0,xxxxxxxx | 0發(fā)送短信失敗,xxxxxxxx代表消息編號(hào) | 2 | 余額不夠 | 3 | 扣費(fèi)失?。ㄕ?qǐng)聯(lián)系客服） | 5,xxxxxxxx | 短信定時(shí)成功, xxxxxxxx代表消息編號(hào) | 6 | 有效號(hào)碼為空 | 7 | 短信內(nèi)容為空 | 8 | 無簽名，必須，格式：【簽名】 | 9 | 沒有Url提交權(quán)限 | 10 | 發(fā)送號(hào)碼過多,最多支持200個(gè)號(hào)碼 | 11 | 產(chǎn)品ID異常 | 12 | 參數(shù)異常 | 13 | 30分種重復(fù)提交 | 15 | Ip驗(yàn)證失敗 | 19 | 短信內(nèi)容過長，最多支持500個(gè) | 20 | 定時(shí)時(shí)間不正確：格式：20130202120212(14位數(shù)字) |
3、余額查詢提交地址：http://192.168.0.188:8800/balance.do 余額接口提交方式：GET 功能：查詢短信剩余數(shù)量 輸入?yún)?shù) | 描述 | username | 用戶名 | password | 密碼 |
樣例： http://192.168.0.188:8800/balance.do?username=userccc&password=XXXX&productid=677678 返回參數(shù) | 描述 | 200 | 200代表短信的數(shù)量 | -1 | 用戶名或者密碼不正確 | -2 | 沒有url提交權(quán)限 | -3 | 用戶不存在或用戶停用 |
4、狀態(tài)報(bào)告狀態(tài)報(bào)告接口提交方式：GET 功能：ZT平臺(tái)會(huì)實(shí)時(shí)把發(fā)送的消息報(bào)告推送到用戶配置的下行地址中。用戶獲取網(wǎng)關(guān)發(fā)送的數(shù)據(jù),接收成功返回0，接收不到數(shù)據(jù)返回非0 推送后用戶方?jīng)]有返回值，ZT平臺(tái)默認(rèn)推送三次后，不再推送 方式1：單條推送方式 此方式需要用戶在ZT平臺(tái)填寫下行地址 例如： 我平臺(tái)每次返回1組內(nèi)容，客戶被動(dòng)接收狀態(tài)報(bào)告并解析之 推送URL格式： msgid=xxxxx&mobile=xxxxxx&status=xxxxxxx 返回參數(shù) | 消息報(bào)告參數(shù)描述 | msgid | 推送的消息id | mobile | 推送的手機(jī) | status | 返回的狀態(tài)。1代表成功，非1代表失敗 | 0 | 返回值。用戶接收成功需要向ZT平臺(tái)返回0 |
方式2：批量推送方式（客服設(shè)置）間隔5秒/次 此方式需要用戶在ZT平臺(tái)填寫下行地址 我平臺(tái)每次返回50(最大)組內(nèi)容，客戶被動(dòng)接收狀態(tài)報(bào)告并解析之 推送URL格式：例如： Param參數(shù)規(guī)則如下：消息ID,手機(jī)號(hào)碼,狀態(tài),時(shí)間; 消息ID,手機(jī)號(hào)碼,狀態(tài),時(shí)間 說明：每一組中由消息ID，手機(jī)號(hào)碼，狀態(tài)，時(shí)間組成，并由英文,分開，每一組之間又由英文;分開 返回參數(shù) | 消息報(bào)告參數(shù)描述 | param | 包括推送的消息id | 包括推送的手機(jī) | 包括返回的狀態(tài)。1代表成功，非1代表失敗 | 包括狀態(tài)時(shí)間,格式為：yyyyMMddHHmmss | 0 | 返回值。用戶接收成功需要向ZT平臺(tái)返回0 |
方式3：主動(dòng)提取狀態(tài)報(bào)告 （客服設(shè)置） 我平臺(tái)每次返回50(最大)組內(nèi)容，客戶被動(dòng)接收狀態(tài)報(bào)告并解析之，時(shí)間間隔最好定為1分鐘左右，輸入?yún)?shù)包括用戶名和密碼 提取URL地址：例如：http://192.168.0.188:8800/batchreportget.do? username=xxx& password=xxxx 說明：每一組中由消息ID，手機(jī)號(hào)碼，狀態(tài)，時(shí)間組成，并由英文,分開，每一組之間又由英文;分開
返回參數(shù) | 消息報(bào)告參數(shù)描述 | 非空字符串 | 包括推送的消息id | 包括推送的手機(jī) | 包括返回的狀態(tài)。1代表成功，非1代表失敗 | 包括狀態(tài)時(shí)間,格式為：yyyy-MM-dd HH:mm:ss | -3 | 異常情況 | -2 | 沒有可取數(shù)據(jù) | -1 | 用戶名或密碼錯(cuò)誤 |
5、回復(fù)內(nèi)容接口回復(fù)接口提交方式：GET 功能：獲取上行內(nèi)容，ZT平臺(tái)會(huì)自動(dòng)實(shí)時(shí)的推送用戶手機(jī)回復(fù)的內(nèi)容到上行地址中。推送后用戶方?jīng)]有返回值，ZT平臺(tái)默認(rèn)推送三次后，不再推送 方式1：推送方式 此方式需要在ZT短信平臺(tái)中填寫上行地址 例如： 推送URL格式： mobile=xxxx&content=xxxxx&msgid=xxxxx&xh=xxxxx; 返回參數(shù) | 回復(fù)內(nèi)容參數(shù)描述 | msgid | 回復(fù)的消息id | mobile | 回復(fù)的手機(jī)號(hào)碼 | content | 手機(jī)回復(fù)的內(nèi)容 | xh | 推送的用戶小號(hào) | 0 | 返回值。用戶接收成功需要向ZT平臺(tái)返回0 |
一次推送一個(gè)號(hào)碼，mobile指手機(jī)號(hào)，content指回復(fù)的內(nèi)容，msgid指上行對(duì)應(yīng)的msgid，xh代表擴(kuò)展號(hào)碼。 用戶接收回復(fù)內(nèi)容成功，需要返回 ZT平臺(tái)0。 回復(fù)內(nèi)容接口推送的內(nèi)容樣例：13012345678,內(nèi)容,12121209876512,1023； 方式2：主動(dòng)提取 時(shí)間間隔最好定為1分鐘左右,此方式需要在ZT短信平臺(tái)中填寫上行地址，地址一定要標(biāo)記為：initiative-grab-reply 輸入?yún)?shù)包括用戶名和密碼，提取地址：http://192.168.0.188:8800/ batchreplyget.do? username=xxx& password=xxxx 說明：返回格式為：手機(jī)號(hào)，內(nèi)容，消息ID，小號(hào)，他們之間以[r]分開，分組之間以[p]分開，最大返回50組內(nèi)容。,只能取一次 返回參數(shù) | 回復(fù)內(nèi)容參數(shù)描述 | 非空內(nèi)容 | 格式說明：手機(jī)號(hào)[r]內(nèi)容[r]消息ID[r]小號(hào)[p] 手機(jī)號(hào)[r]內(nèi)容[r]消息ID[r]小號(hào) | -3 | 異常情況 | -2 | 沒有可取數(shù)據(jù) | -1 | 用戶名或密碼錯(cuò)誤 |
、發(fā)送量數(shù)據(jù)報(bào)表提取查詢地址：提交地址：http://192.168.0.188:8800/submitStatistics.do 功能說明： 主要是查詢用戶發(fā)送的短信條數(shù)數(shù)據(jù)，根據(jù)時(shí)間查詢（報(bào)表系統(tǒng)已經(jīng)生成，所以不會(huì)變化,數(shù)據(jù)非當(dāng)天的），查詢數(shù)據(jù)包含用戶自己及下面的子用戶或終端 輸入?yún)?shù)： 輸入?yún)?shù) | 描述 | username | 用戶名 | password | 密碼 | dstime | 查詢?nèi)掌?格式：20120202) |
輸出參數(shù)： 返回參數(shù) | 描述 | Xxx,數(shù)量 | 示例：用戶名1,條數(shù);用戶名2,條數(shù) 數(shù)據(jù)之間先以,隔開，不同用戶之間以;分開 | -1 | 用戶名或者密碼不正確 | -2 | 無查詢數(shù)據(jù) | -3 | 查詢異常 |
2.2. (webservice方式)接口提交地址：192.168.0.188:8800/ztws/SendsmsWebService?wsdl 1、普通短信調(diào)用方法： sendSms(String username,String password,String oldMobile,String content,String product_number,String dstime,String xh,String repeat) 輸入?yún)?shù) | 描述 | username | 用戶名（必填） | password | 密碼（必填MD5加密,小寫） | oldMobile | 手機(jī)號(hào)，多個(gè)手機(jī)號(hào)為用半角 , 分開，如13899999999,13688888888(最多2000個(gè)，必填) | content | 發(fā)送內(nèi)容（必填） | product_number | 產(chǎn)品ID | dstime | 定時(shí)時(shí)間，為空時(shí)表示立即發(fā)送（選填） 格式：20130202120212 | xh | 擴(kuò)展的小號(hào),必須為數(shù)字，沒有請(qǐng)留空 | repeat | 發(fā)送不可重復(fù)的短信, 1時(shí)可以重復(fù)，0不能重復(fù) |
返回結(jié)果： 返回參數(shù) | 描述 | -1 | 用戶名或者密碼不正確 | 1,xxxxxxxx | 1代表發(fā)送短信成功,xxxxxxxx代表消息編號(hào) | 0,xxxxxxxx | 0發(fā)送短信失敗,xxxxxxxx代表消息編號(hào) | 2 | 余額不夠 | 3 | 扣費(fèi)失敗（請(qǐng)聯(lián)系客服） | 5,xxxxxxxx | 短信定時(shí)成功, xxxxxxxx代表消息編號(hào) | 6 | 有效號(hào)碼為空 | 7 | 短信內(nèi)容為空 | 8 | 無簽名，必須，格式：【簽名】 | 9 | 沒有Url提交權(quán)限 | 10 | 發(fā)送號(hào)碼過多,最多支持2000個(gè)號(hào)碼 | 11 | 產(chǎn)品ID異常 | 12 | 參數(shù)異常 | 13 | 30分種重復(fù)提交 | 15 | Ip驗(yàn)證失敗 | 19 | 短信內(nèi)容過長，最多支持500個(gè) | 20 | 定時(shí)時(shí)間不正確：格式：20130202120212(14位數(shù)字) |
2、變量短信調(diào)用方法：sendChangeSms(String username,String password,String content,String mobile,String product_number,String dstime,String xh) 輸入?yún)?shù) | 描述 | username | 用戶名（必填） | password | 密碼（必填MD5加密,小寫） | content | 發(fā)送內(nèi)容多個(gè)內(nèi)容用※分開，如短信1【簽名】※短信2【簽名】（必填） | mobile | 手機(jī)號(hào)，多個(gè)手機(jī)號(hào)為用半角 , 分開，如13899999999,13688888888(最多200個(gè)，必填) | product_number | 產(chǎn)品id(必填) | dstime | 定時(shí)時(shí)間，為空時(shí)表示立即發(fā)送（選填） 格式：20130202120212 | xh | 擴(kuò)展的小號(hào),必須為數(shù)字，沒有請(qǐng)留空 |
返回結(jié)果： 返回參數(shù) | 描述 | -1 | 用戶名或者密碼不正確 | 1,xxxxxxxx | 1代表發(fā)送短信成功,xxxxxxxx代表消息編號(hào) | 0,xxxxxxxx | 0發(fā)送短信失敗,xxxxxxxx代表消息編號(hào) | 2 | 余額不夠 | 3 | 扣費(fèi)失敗（請(qǐng)聯(lián)系客服） | 5,xxxxxxxx | 短信定時(shí)成功, xxxxxxxx代表消息編號(hào) | 6 | 有效號(hào)碼為空 | 7 | 短信內(nèi)容為空 | 8 | 無簽名，必須，格式：【簽名】 | 9 | 沒有Url提交權(quán)限 | 10 | 發(fā)送號(hào)碼過多,最多支持200個(gè)號(hào)碼 | 11 | 產(chǎn)品ID異常 | 12 | 參數(shù)異常 | 13 | 30分種重復(fù)提交 | 15 | Ip驗(yàn)證失敗 | 19 | 短信內(nèi)容過長，最多支持500個(gè) | 20 | 定時(shí)時(shí)間不正確：格式：20130202120212(14位數(shù)字) |
3、余額查詢調(diào)用方法：getBalanceApi(String username, String password,String product_number) 功能：查詢短信剩余數(shù)量 輸入?yún)?shù) | 描述 | username | 用戶名 | password | 密碼 | product_number | 產(chǎn)品ID |
查詢結(jié)果 返回參數(shù) | 描述 | 200 | 200代表短信的數(shù)量 | -1 | 用戶名或者密碼不正確 | -2 | 沒有url提交權(quán)限 | -3 | 用戶不存在或用戶停用 |
4、狀態(tài)報(bào)告調(diào)用方法：getBatchReport(String username, String password) 功能：批量提取狀態(tài)報(bào)告 輸入?yún)?shù) | 描述 | username | 用戶名 | password | 密碼 |
我平臺(tái)每次返回50(最大)組內(nèi)容，客戶被動(dòng)接收狀態(tài)報(bào)告并解析之，時(shí)間間隔最好定為1分鐘左右，輸入?yún)?shù)包括用戶名和密碼 說明：每一組中由消息ID，手機(jī)號(hào)碼，狀態(tài)，時(shí)間組成，并由英文,分開，每一組之間又由英文;分開 返回參數(shù) | 消息報(bào)告參數(shù)描述 | 非空字符串 | 包括推送的消息id | 包括推送的手機(jī) | 包括返回的狀態(tài)。1代表成功，非1代表失敗 | 包括狀態(tài)時(shí)間,格式為：yyyyMMddHHmmss | -3 | 異常情況 | -2 | 沒有可取數(shù)據(jù) | -1 | 用戶名或密碼錯(cuò)誤 |
5、回復(fù)內(nèi)容接口調(diào)用方法：getReplyData(String username, String password) 功能：批量提取狀態(tài)報(bào)告 輸入?yún)?shù) | 描述 | username | 用戶名 | password | 密碼 |
時(shí)間間隔最好定為1分鐘左右,此方式需要在ZT短信平臺(tái)中填寫上行地址，地址一定要標(biāo)記為：initiative-grab-reply 返回參數(shù) | 回復(fù)內(nèi)容參數(shù)描述 | 非空內(nèi)容 | 格式說明：手機(jī)號(hào)[r]內(nèi)容[r]消息ID[r]小號(hào)[p] 手機(jī)號(hào)[r]內(nèi)容[r]消息ID[r]小號(hào) | -3 | 異常情況 | -2 | 沒有可取數(shù)據(jù) | -1 | 用戶名或密碼錯(cuò)誤 |
、發(fā)送量數(shù)據(jù)報(bào)表提取調(diào)用方法：getSubmitStatistics(String username,String password,String dstime) 功能說明： 主要是查詢用戶發(fā)送的短信條數(shù)數(shù)據(jù)，根據(jù)時(shí)間查詢（報(bào)表系統(tǒng)已經(jīng)生成，所以不會(huì)變化,數(shù)據(jù)非當(dāng)天的），查詢數(shù)據(jù)包含用戶自己及下面的子用戶或終端 輸入?yún)?shù)： 輸入?yún)?shù) | 描述 | username | 用戶名 | password | 密碼 | dstime | 查詢?nèi)掌?格式：20120202) |
輸出參數(shù)： 返回參數(shù) | 描述 | Xxx,數(shù)量 | 示例：用戶名1,條數(shù);用戶名2,條數(shù) 數(shù)據(jù)之間先以,隔開，不同用戶之間以;分開 | -1 | 用戶名或者密碼不正確 | -2 | 無查詢數(shù)據(jù) | -3 | 查詢異常 |
2.3.（socket方式）接口1、普通短信 提交地址：192.168.0.188:8800 端口號(hào)：2030 輸入?yún)?shù) | 描述 | username | 用戶名（必填） | password | 密碼（必填MD5加密,小寫） | mobile | 手機(jī)號(hào)，多個(gè)手機(jī)號(hào)為用半角 , 分開，如13899999999,13688888888(最多2000個(gè)，必填) | content | 發(fā)送內(nèi)容（必填） | dstime | 定時(shí)時(shí)間，為空時(shí)表示立即發(fā)送（選填） 格式：20130202120212 | productid | 產(chǎn)品id(必填) | xh | 擴(kuò)展的小號(hào)（選填）,必須為數(shù)字，沒有請(qǐng)留空 | process_type | 0,普通發(fā)送，1變量發(fā)送，2查詢余額信息，3取回復(fù)信息，4取狀態(tài)報(bào)告信息（必填） |
返回參數(shù) | 描述 | -1 | 用戶名或者密碼不正確 | 1,xxxxxxxx | 1代表發(fā)送短信成功,xxxxxxxx代表消息編號(hào) | 0,xxxxxxxx | 0發(fā)送短信失敗,xxxxxxxx代表消息編號(hào) | 2 | 余額不夠 | 3 | 扣費(fèi)失?。ㄕ?qǐng)聯(lián)系客服） | 5,xxxxxxxx | 短信定時(shí)成功, xxxxxxxx代表消息編號(hào) | 6 | 有效號(hào)碼為空 | 7 | 短信內(nèi)容為空 | 8 | 無簽名，必須，格式：【簽名】 | 9 | 沒有Url提交權(quán)限 | 10 | 發(fā)送號(hào)碼過多,最多支持2000個(gè)號(hào)碼 | 11 | 產(chǎn)品ID異常 | 12 | 參數(shù)異常 | 13 | 30分種重復(fù)提交 | 15 | Ip驗(yàn)證失敗 | 19 | 短信內(nèi)容過長，最多支持500個(gè) | 20 | 定時(shí)時(shí)間不正確：格式：20130202120212(14位數(shù)字) |
2、變量短信輸入?yún)?shù) | 描述 | username | 用戶名（必填） | password | 密碼（必填MD5加密,小寫） | content | 發(fā)送內(nèi)容多個(gè)內(nèi)容用※分開，如短信1【簽名】※短信2【簽名】（必填） | mobile | 手機(jī)號(hào)，多個(gè)手機(jī)號(hào)為用半角 , 分開，如13899999999,13688888888(最多200個(gè)，必填) | productid | 產(chǎn)品id(必填) | dstime | 定時(shí)時(shí)間，為空時(shí)表示立即發(fā)送（選填） 格式：20130202120212 | xh | 擴(kuò)展的小號(hào),必須為數(shù)字，沒有請(qǐng)留空 | process_type | 0,普通發(fā)送，1變量發(fā)送，2查詢余額信息，3取回復(fù)信息，4取狀態(tài)報(bào)告信息（必填） |
返回參數(shù) | 描述 | -1 | 用戶名或者密碼不正確 | 1,xxxxxxxx | 1代表發(fā)送短信成功,xxxxxxxx代表消息編號(hào) | 0,xxxxxxxx | 0發(fā)送短信失敗,xxxxxxxx代表消息編號(hào) | 2 | 余額不夠 | 3 | 扣費(fèi)失?。ㄕ?qǐng)聯(lián)系客服） | 5,xxxxxxxx | 短信定時(shí)成功, xxxxxxxx代表消息編號(hào) | 6 | 有效號(hào)碼為空 | 7 | 短信內(nèi)容為空 | 8 | 無簽名，必須，格式：【簽名】 | 9 | 沒有Url提交權(quán)限 | 10 | 發(fā)送號(hào)碼過多,最多支持200個(gè)號(hào)碼 | 11 | 產(chǎn)品ID異常 | 12 | 參數(shù)異常 | 13 | 30分種重復(fù)提交 | 15 | Ip驗(yàn)證失敗 | 19 | 短信內(nèi)容過長，最多支持500個(gè) | 20 | 定時(shí)時(shí)間不正確：格式：20130202120212(14位數(shù)字) |
3、余額查詢功能：查詢短信剩余數(shù)量 輸入?yún)?shù) | 描述 | username | 用戶名 | password | 密碼 | productid | 產(chǎn)品ID | process_type | 0,普通發(fā)送，1變量發(fā)送，2查詢余額信息，3取回復(fù)信息，4取狀態(tài)報(bào)告信息（必填） |
查詢結(jié)果 返回參數(shù) | 描述 | 200 | 200代表短信的數(shù)量 | -1 | 用戶名或者密碼不正確 | -2 | 沒有url提交權(quán)限 | -3 | 用戶不存在或用戶停用 |
4、狀態(tài)報(bào)告功能：批量提取狀態(tài)報(bào)告 輸入?yún)?shù) | 描述 | username | 用戶名 | password | 密碼 | process_type | 0,普通發(fā)送，1變量發(fā)送，2查詢余額信息，3取回復(fù)信息，4取狀態(tài)報(bào)告信息（必填） |
查詢結(jié)果: 我平臺(tái)每次返回50(最大)組內(nèi)容，客戶被動(dòng)接收狀態(tài)報(bào)告并解析之，時(shí)間間隔最好定為1分鐘左右，輸入?yún)?shù)包括用戶名和密碼 說明：每一組中由消息ID，手機(jī)號(hào)碼，狀態(tài)，時(shí)間組成，并由英文,分開，每一組之間又由英文;分開 返回參數(shù) | 消息報(bào)告參數(shù)描述 | 非空字符串 | 包括推送的消息id | 包括推送的手機(jī) | 包括返回的狀態(tài)。1代表成功，非1代表失敗 | 包括狀態(tài)時(shí)間,格式為：yyyyMMddHHmmss | -3 | 異常情況 | -2 | 沒有可取數(shù)據(jù) | -1 | 用戶名或密碼錯(cuò)誤 |
5、回復(fù)內(nèi)容接口功能：批量提取回復(fù)信息 輸入?yún)?shù) | 描述 | username | 用戶名 | password | 密碼 | process_type | 0,普通發(fā)送，1變量發(fā)送，2查詢余額信息，3取回復(fù)信息，4取狀態(tài)報(bào)告信息（必填） |
時(shí)間間隔最好定為1分鐘左右,此方式需要在ZT短信平臺(tái)中填寫上行地址，地址一定要標(biāo)記為：initiative-grab-reply 返回參數(shù) | 回復(fù)內(nèi)容參數(shù)描述 | 非空內(nèi)容 | 格式說明：手機(jī)號(hào)[r]內(nèi)容[r]消息ID[r]小號(hào)[p] 手機(jī)號(hào)[r]內(nèi)容[r]消息ID[r]小號(hào) | -3 | 異常情況 | -2 | 沒有可取數(shù)據(jù) | -1 | 用戶名或密碼錯(cuò)誤 |
、發(fā)送量數(shù)據(jù)報(bào)表提取提交地址：192.168.0.188:8800 端口號(hào)：2030 功能說明： 主要是查詢用戶發(fā)送的短信條數(shù)數(shù)據(jù)，根據(jù)時(shí)間查詢（報(bào)表系統(tǒng)已經(jīng)生成，所以不會(huì)變化,數(shù)據(jù)非當(dāng)天的），查詢數(shù)據(jù)包含用戶自己及下面的子用戶或終端 輸入?yún)?shù)： 輸入?yún)?shù) | 描述 | username | 用戶名 | password | 密碼 | dstime | 查詢?nèi)掌?格式：20120202) | process_type | 必填，此處填5 |
|
輸出參數(shù)： 返回參數(shù) | 描述 | Xxx,數(shù)量 | 示例：用戶名1,條數(shù);用戶名2,條數(shù) 數(shù)據(jù)之間先以,隔開，不同用戶之間以;分開 | -1 | 用戶名或者密碼不正確 | -2 | 無查詢數(shù)據(jù) | -3 | 查詢異常 |
注：詳細(xì)客戶端DEMO請(qǐng)聯(lián)系客服索取。 第三章 環(huán)境要求3.1.網(wǎng)絡(luò)拓?fù)鋱D  3.2.環(huán)境要求本節(jié)將詳細(xì)說明正確發(fā)送/接收短信的前提條件： 確保企業(yè)服務(wù)器端可以通過http上網(wǎng) 確保企業(yè)服務(wù)器端有固定IP, 如需要，可對(duì)企業(yè)方的IP進(jìn)行鑒權(quán)
信息發(fā)布：廣州名易軟件有限公司 http://m.jetlc.com
|
名易MyOA協(xié)同綜合辦公平臺(tái)
名易MyCRM客戶關(guān)系管理平臺(tái)
名易MyHR人力資源管理平臺(tái)
名易MyIDP智能開發(fā)平臺(tái)
名易MyIBP保險(xiǎn)業(yè)務(wù)管理平臺(tái)
名易MyHMS酒店綜合管理系統(tǒng)
名易MyPM項(xiàng)目管理平臺(tái)
名易MyTMS物流運(yùn)輸管理平臺(tái)
名易MyVMS汽車綜合管理系統(tǒng)
名易MyIMS貸款管理系統(tǒng)
名易MyEDU教育管理平臺(tái)
名易MyPCS生產(chǎn)事務(wù)協(xié)調(diào)系統(tǒng)
名易MyWIDP微信智能開發(fā)平臺(tái)
