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

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

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

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

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

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

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

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

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

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

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