三網合一短信接口文檔v2.0一、HTTP接口調用說明(支持POST和GET)HTTP網關地址:UTF8編碼網關55:6000/utf8/web_api/SendSMS_V2.aspxGBK 編碼網關55:6000/gbk/web_api/SendSMS_V2.aspx提示:HTTP調用URL接口時, 參數值必須URL編碼后再調用1.1 參數說明序號參數名描述1X_sid會員編號2X_eid企業編號3X_uid會員帳號4X_pwd_md5MD5（MD5（密碼）+本機外網ip）英文字母全是小寫5X_ac操作指令10 發送普通短信70字12 發送長短信450字13發送打包短信不同內容20 接收回復短信30查詢賬戶余額50修改接口密碼100 獲取外網IP，用于生成x_pwd_md56X_gate_id300固定不能修改7X_target_no接口短信手機號，多個號碼用逗號分開，最多支持100條每次8X_memo短信發送內容，最多450字符,必須url編碼1.2發送短信1.2.1發送普通短信（70字） 請求參數X_ac=10&x_eid=企業代碼&x_uid=會員帳號&x_pwd_md5=訪問密碼&x_gate_id=300&x_target_no=接收手機號&x_memo=發送短信內容1.2.1發送長短信(450字) 請求參數X_ac=12&x_eid=企業代碼&x_uid=會員帳號&x_pwd_md5=訪問密碼&x_gate_id=300&x_target_no=接收手機號&x_memo=發送短信內容返回值描述類型值int0(大于0) 成功計費條數=0 (小于等于0) 失敗2.接收回復短信(分主動和被動兩種接收)2.1主動接收回復短信(最小調用間隔30秒一次) 請求參數X_ac=20&x_eid=企業代碼&x_uid=會員帳號&x_pwd_md5=訪問密碼&x_gate_id=300 返回XML格式（返回2條用戶回復的短信）1(序列號可以忽略)1001（會員編號,如果有多個帳號情況下回復手機號)能收到我回復的測試短信么？（回復內容）2009-11-21 16:54:14(回復時間)10655059052084（回復到網關的號碼）1200 (用戶擴展碼) 2100213020930000這是第二條測試短信!2009-11-21 16:13:3710655059052084101 2.2被動接收回復短信（如果有新回復短信，我們會主動以PUSH方式發送給用戶指定的頁面） 此方式采用http+xml+post技術，需要用戶提供一個接收短信頁面地址 以下是post+xml時的樣本： 11001這個是被動回復過來的，能收到么？ 2008-03-14 23:07:39 1065810889988 101 3.查詢短信余額請求參數X_ac=30&x_eid=企業代碼&x_uid=會員帳號&x_pwd_md5=訪問密碼&x_gate_id=300 返回值Sms:10000,mms:5000描述Sms:指短信剩余條數，mms:指彩信剩余條數4.修改接口密碼請求參數X_ac=50&x_eid=企業代碼&x_uid=會員帳號&x_pwd_md5=訪問密碼&x_new_pwd=接口新密碼MD5&x_gate_id=300 返回值 1 修改新密碼成功，否則失敗。5.打包提交不同內容短信(最多支持100個包),必須使用POST方式請求參數(只接受POST方式)X_ac=13&x_eid=企業代碼&x_uid=會員帳號&x_pwd_md5=訪問密碼&x_gate_id=300&x_memo=xml格式x_memo格式如下 編號 (如果失敗，會輸出這個編號,保證此包里不要重復)用戶手機號碼1長短信，0普通短信,(超過70字自動設置1)擴展碼 返回值(Int數字類型) 大于0成功，否則失敗6.獲取公網ip用于驗證訪問密碼，x_pwd_md5需要用到這個值請求參數X_ac=100返回值00HTTP返回值參對表編號值說明1大于0發送成功,此次發送成功條數2-1參數無效3-2通道不存在或者當前業務不支持此通道4-3定時格式錯誤5-4接收號碼無效6-5提交號碼個數超過上限,每個通道都有批量提交的上限.詳細值請參考通道說明7-6發送短信內容長度不符合要求,參考通道要求長度8-7當前賬戶余額不足9-8網關發送短信時出現異常10-9用戶或者密碼沒輸入11-10企業ID或者會員賬號不存在12-11密碼錯誤13-12賬戶鎖定14-13網關狀態關閉15-14驗證用戶時執行異常16-15網關初始化失敗17-16當前IP已被系統屏蔽,可能是與您設置的接入IP不同或者是失敗次數太多18-17發送異常19-18賬號未審核20-19當前時間不允許此通道工作，主要對群發通道限制21-20傳輸密鑰未設置，請登陸平臺設置22-21提取密鑰異常23-22簽名驗證失敗24-23發現屏蔽關鍵字25-100到-199運營商返回失敗代碼二、WebService調用方式WS網關地址:Utf8網關 55:6000/utf8/ws_api/WebSMS_V2.asmxGBK網關55:6000/gbk/ws_api/WebSMS_V2.asmxWebService服務函數目錄1.EditPWD 修改接口密碼,平臺登錄密碼不受影響 2.FastSend 快速發送短信,直接提交到運營商,本站不存儲任何數據.返回值:SendResult 自定義類 3.FastSendLongSMS 發送長短信,最多支持450字.按64字計費,本站不存儲任何數據.返回值:SendResult 自定義類 4.GetBalance 查詢賬戶剩余短信/彩信條數,返回值:sms:100,mms:100 當前余額,否則返回失敗代碼 5.GetUpSMS 客戶主動讀取上行短信,最小間隔30秒,返回多個Woxp_UpSMS上行類。每條上行信息生成一個類,沒有上行就返回NULL 6.SendXMLPack 打包發送短信，適合不同內容批量提交，以xml格式打包，上限100條.返回值:SendResult 公共參數調用描述eid_pwd_gateId，該參數是字符串類型，由多個值拼成所有函數都必須依賴這個參數來提供服務參數格式（ 會員編號-企業代碼會員帳號MD5（MD5（接口密碼）+登錄IP）-通道號）各個參數用-分開參數例如（1）會員編號：15（2）企業代碼：10001（3）會員帳號：smsone（4）登錄MD5: e10adc3949ba59abbe56e057f20f883e, MD5（MD5（接口密碼）+登錄IP）登錄IP可以由55:6000/utf8/web_api/SendSMS_V2.aspx?x_ac=100獲取（5）通道號:300(這個是固定值)eid_pwd_gateId =15-10001-smsone-e10adc3949ba59abbe56e057f20f883e-300 (注意分隔符-半角下輸入)1. 修改接口密碼 public int EditPWD(string eid_pwd_md5, string newPwd_md5) 參數描述 newPwd_md5,新接口密碼MD5值（32 位） 返回值 1成功，否則失敗.2.發送普通短信70字 public SendResult FastSend(string eid_pwd_gateId, string TargetNo, string MsgContent, string SendTime, string strSubId)參數描述（1） TargetNo 發送手機號碼，多個號碼用逗號分開。最多支持100個號碼（2） MsgContent 發送短信內容，最多70個字符（3） SendTime 定時發送時間，暫時為null,預留參數（4） strSubId 擴展碼，確認不同用戶回復返回值: SendResult自定義類 string int(是否成功由這個值確定，大于0成功其它值失敗) string int string string string成功標識 RetCode值大于0代表發送成功，返回計費條數，否則就返回失敗代碼3.發送長短信450字public SendResult FastSendLongSMS(string eid_pwd_gateId, string TargetNo, string MsgContent, string SendTime, string strSubId)解釋同【發送普通短信70字】一樣，請參考FastSend上面說明.4.查詢賬戶余額public string GetBalance(string eid_pwd_md5)調用成功后返回值Sms:1000,mms:1000該帳號剩余短信1000條，彩信1000條5.獲取用戶回復的短信public Woxp_UpSMS GetUpSMS(string eid_pwd_gateId)返回值， 如果有回復短信返回Woxp_UpSMS數組集合.每個數組存儲回復詳細信息。否則為NULL Woxp_UpSMS 自定義類型 int (上行編號，可以忽略) int (會員編號區分企業下面多個帳號) string (回復者的手機號) string (回復內容) string (回復時間) string (用戶擴展碼，區分哪個用戶回復) stri