短信發(fā)送接口平臺(tái)-http接口文檔

1、 短信發(fā)送接口平 臺(tái) http接口文檔首次發(fā)布日期：文檔編號(hào)：讀者：審閱者：保密等級(jí)：2017年 09 月25日軟件開發(fā)人員希望拿到次文檔的人進(jìn)行保密1. 查詢網(wǎng)址 管理后臺(tái)登陸： /登錄帳號(hào)和密碼由提供商提供參數(shù)傳遞方式都采用http 網(wǎng)頁post的提交的方式，get方式不支持2. 短信發(fā)送接口（用戶向平臺(tái)請求短信發(fā)送）入?yún)?shù)傳入?yún)?shù):參數(shù)1：Account 商戶登錄賬號(hào)，默認(rèn)是手機(jī)號(hào)參數(shù)2：Function 短信發(fā)送值默認(rèn)為：MT參數(shù)3：Key 加密竄，為Account + Function + Orderid + MD5KEY 組合加密而成，采用MD5的加密方式，加密后進(jìn)行小寫。 MD5

2、KEY 由管理員后臺(tái)設(shè)置參數(shù)4： Orderid 單筆發(fā)送訂單號(hào)或批次號(hào)，32位以內(nèi)參數(shù)5: Ext 發(fā)送擴(kuò)展號(hào)，根據(jù)實(shí)際情況確定是否有用參數(shù)6：Report 發(fā)送結(jié)果是否返回，默認(rèn)不返回參數(shù)7：Phone 發(fā)送的手機(jī)號(hào)碼，多個(gè)手機(jī)號(hào)碼之間用英文的逗號(hào),隔開，理論上可以一次性發(fā)送幾萬次，但是考慮到超時(shí)情況，建議每次發(fā)送號(hào)碼的數(shù)量不要超過 5000個(gè)參數(shù)8: Message 發(fā)送的內(nèi)容參數(shù)9: Other 備用，可存儲(chǔ)內(nèi)容，病返回參數(shù)10: Sendtime 發(fā)送時(shí)間，當(dāng)服務(wù)器時(shí)間接近于發(fā)送時(shí)間的10分鐘內(nèi)，將會(huì)進(jìn)行發(fā)送。時(shí)間格式為：2017-09-25 14:41:44接口描述用戶可根據(jù)此函數(shù)

3、提交短信發(fā)送接口地址返回函數(shù)返回結(jié)果，為JSON格式，詳細(xì)參數(shù)如下：返回參數(shù)為：參數(shù)1：Result 返回參數(shù)值參數(shù)2：MSG 返回參數(shù)值說明參數(shù)3：Backtime 返回時(shí)間參數(shù)4：Account 客戶的登錄賬號(hào)參數(shù)4：Param1 擴(kuò)展參數(shù)1 如果提交成功，此處為平臺(tái)的交易流水號(hào)參數(shù)5：Param2 擴(kuò)展參數(shù)2 ，暫時(shí)為空參數(shù)6：Param3 擴(kuò)展參數(shù)3 ，提交成功后，返回Other值參數(shù)7：Param4 擴(kuò)展參數(shù)4 ，暫時(shí)為空參數(shù)8：Param5 擴(kuò)展參數(shù)5 ，暫時(shí)為空Result 由以下結(jié)果-2 參數(shù)提交有誤-3無此用戶或用戶被凍結(jié)-4 IP地址不準(zhǔn)確-5獲取短信發(fā)送參數(shù)有誤-6簽名驗(yàn)

4、證不通過-7重復(fù)提交-8查詢異常，重新提交-11余額不足-12 寫入數(shù)據(jù)庫時(shí)異常 0成功提交，發(fā)送處理中-9提交異常，請先進(jìn)行查詢確認(rèn)后在提交-10提交狀態(tài)未知，請先查詢后再提交3. 變量短信發(fā)送接口（用戶向平臺(tái)請求短信發(fā)送）入?yún)?shù)傳入?yún)?shù):參數(shù)1：Account 商戶登錄賬號(hào)，默認(rèn)是手機(jī)號(hào)參數(shù)2：Function 短信發(fā)送值默認(rèn)為：BL參數(shù)3：Key 加密竄，為Account + Function + Orderid + MD5KEY 組合加密而成，采用MD5的加密方式，加密后進(jìn)行小寫。 MD5KEY 由管理員后臺(tái)設(shè)置參數(shù)4： Orderid 單筆發(fā)送訂單號(hào)或批次號(hào)，32位以內(nèi)參數(shù)5: Ex

5、t 發(fā)送擴(kuò)展號(hào)，根據(jù)實(shí)際情況確定是否有用參數(shù)6：Report 發(fā)送結(jié)果是否返回，默認(rèn)不返回參數(shù)7：Params 變量格式為：手機(jī)號(hào),變量1,變量2 多個(gè)內(nèi)容之間用 英文的;分號(hào)隔開，例如123443214321 變量總數(shù)不能超過10個(gè)。參數(shù)8: Message 發(fā)送的內(nèi)容，最多支持10個(gè)變量進(jìn)行發(fā)送，比如為：$var1,$var2,$var3,例如：親愛的$var1,您的驗(yàn)證碼為：$var2。參數(shù)9: Other 備用，可存儲(chǔ)內(nèi)容，病返回參數(shù)10: Sendtime 發(fā)送時(shí)間，當(dāng)服務(wù)器時(shí)間接近于發(fā)送時(shí)間的10分鐘內(nèi)，

6、將會(huì)進(jìn)行發(fā)送。時(shí)間格式為：2017-09-25 14:41:44接口描述用戶可根據(jù)此函數(shù)提交短信發(fā)送接口地址返回函數(shù)返回結(jié)果，為JSON格式，詳細(xì)參數(shù)如下：返回參數(shù)為：參數(shù)1：Result 返回參數(shù)值參數(shù)2：MSG 返回參數(shù)值說明參數(shù)3：Backtime 返回時(shí)間參數(shù)4：Account 客戶的登錄賬號(hào)參數(shù)4：Param1 擴(kuò)展參數(shù)1 如果提交成功，此處為平臺(tái)的交易流水號(hào)參數(shù)5：Param2 擴(kuò)展參數(shù)2 ，暫時(shí)為空參數(shù)6：Param3 擴(kuò)展參數(shù)3 ，提交成功后，返回Other值參數(shù)7：Param4 擴(kuò)展參數(shù)4 ，暫時(shí)為空參數(shù)8：Param5 擴(kuò)展參數(shù)5 ，暫時(shí)為空Result 由以下結(jié)果-2 參

7、數(shù)提交有誤-3無此用戶或用戶被凍結(jié)-4 IP地址不準(zhǔn)確-5獲取短信發(fā)送參數(shù)有誤-6簽名驗(yàn)證不通過-7重復(fù)提交-8查詢異常，重新提交-11余額不足-12 寫入數(shù)據(jù)庫時(shí)異常 0成功提交，發(fā)送處理中-9提交異常，請先進(jìn)行查詢確認(rèn)后在提交-10提交狀態(tài)未知，請先查詢后再提交4. 短信狀態(tài)通知接口（平臺(tái)向用戶發(fā)送狀態(tài)）發(fā)送參數(shù)函數(shù)返回結(jié)果，為JSON格式，詳細(xì)參數(shù)如下：返回參數(shù)為：參數(shù)1：Account 客戶的登錄賬號(hào)參數(shù)2：Count 本次通知狀態(tài)數(shù)量參數(shù)3：Backtime 通知時(shí)間參數(shù)4：Param1 為返回的jason號(hào)碼組，其中每個(gè)組的類型詳細(xì)如下：Param1：各jason組規(guī)則：參數(shù)1：R

8、esult 返回參數(shù)值 參數(shù)2：MSG 平臺(tái)方的唯一訂單號(hào)參數(shù)3：Backtime 收到的時(shí)間參數(shù)4：Account 客戶的登錄賬號(hào)參數(shù)4：Param1 擴(kuò)展參數(shù)1 短信推送時(shí)間參數(shù)5：Param2 擴(kuò)展參數(shù)2 ，用戶的發(fā)送信息的流水號(hào)，orderid參數(shù)6：Param3 擴(kuò)展參數(shù)3 ，返回SP端碼號(hào)參數(shù)7：Param4 擴(kuò)展參數(shù)4 ，發(fā)送短號(hào)參數(shù)8：Param5 擴(kuò)展參數(shù)5 ，平臺(tái)方的批次號(hào)，等同于提交時(shí)Param1 的值Result 由以下結(jié)果1 接收成功0 接收失敗 接口描述此接口為短線狀態(tài)通知接口，系統(tǒng)會(huì)在30分鐘內(nèi)連續(xù)發(fā)送5次回包，接收到回報(bào)OK后即停止發(fā)送返回函數(shù)返回結(jié)果：OK5.

9、 用戶短信回復(fù)通知（平臺(tái)向用戶發(fā)送回復(fù)內(nèi)容）入?yún)?shù)函數(shù)返回結(jié)果，為JSON格式，詳細(xì)參數(shù)如下：返回參數(shù)為：參數(shù)1：Result 返回參數(shù)值參數(shù)2：MSG 用戶回復(fù)的短信內(nèi)容參數(shù)3：Backtime 收到的回復(fù)時(shí)間參數(shù)4：Account 客戶的登錄賬號(hào)參數(shù)4：Param1 擴(kuò)展參數(shù)1 回復(fù)的用戶手機(jī)號(hào)碼參數(shù)5：Param2 擴(kuò)展參數(shù)2 ，對(duì)應(yīng)的用戶的流水號(hào)參數(shù)6：Param3 擴(kuò)展參數(shù)3 ，用戶回復(fù)的碼號(hào)參數(shù)7：Param4 擴(kuò)展參數(shù)4 ，平臺(tái)方的ID號(hào)參數(shù)8：Param5 擴(kuò)展參數(shù)5，對(duì)應(yīng)的發(fā)送時(shí)平臺(tái)方的ID 號(hào)Result 由以下結(jié)果1 接收成功0 接收失敗 接口描述此接口為短線狀態(tài)通知接口

10、，系統(tǒng)會(huì)在30分鐘內(nèi)連續(xù)發(fā)送5次回包，接收到回報(bào)OK后即停止發(fā)送返回ok6. 余額查詢?nèi)雲(yún)?shù)傳入?yún)?shù):參數(shù)1：Account 商戶登錄賬號(hào)，默認(rèn)是手機(jī)號(hào)參數(shù)2：Function 短信發(fā)送值默認(rèn)為：YE參數(shù)3：Key 加密竄，為Account + Function + MD5KEY 組合加密而成，采用MD5的加密方式，加密后進(jìn)行小寫。 MD5KEY 由管理員后臺(tái)設(shè)置接口描述用戶根據(jù)此參數(shù)查詢提交的訂單充值情況。接口地址：返回函數(shù)返回結(jié)果，為JSON格式，詳細(xì)參數(shù)如下：返回參數(shù)為：參數(shù)1：Result 返回參數(shù)值參數(shù)2：MSG 返回參數(shù)值說明參數(shù)3：Backtime 返回時(shí)間參數(shù)4：Account 客戶的登錄賬號(hào)參數(shù)4：Param1 擴(kuò)展參數(shù)1 如果查詢成功，此參數(shù)為賬戶余額參數(shù)5：Param2 擴(kuò)展參數(shù)2 ，如果查詢成功，此參數(shù)為賬戶可發(fā)送短信數(shù)量參數(shù)6：Param3 擴(kuò)展參數(shù)3 ，如果查詢成功，此參數(shù)為用戶傭金，只有在流量或話費(fèi)充值時(shí)才存在參數(shù)7：Param4 擴(kuò)展參數(shù)4 ，暫時(shí)為空參數(shù)6：Para