移動商務無線接口協議

　移動商務 無線接口協議

　201 11 1- -7 7

　1 、 概述 1）、通訊協議是 HTTP 的 webservice（POST 方式提交內容）。

　2）、請求應答過程中使用的中文編碼格式為 UTF-8。

　3)、應答為狀態碼，每個接口下定義具體的狀態碼 4）接口地址：

　?WSDL

　 2 、接口定義 2.1 短信下行接口 接口定義：短信下發。

　接口方法：

　public string SendSms(String username, String password, String phonelist, String msg, Int32 Passagewayid, String SendDatetime) 接口參數：

　參數名稱

　參數描述

　username

　系統分配的用戶帳號 password

　系統分配的用戶密碼 phonelist

　下發信息的手機號碼，多個手機號用半角逗號分隔，每個提交包控制在 100 個手機號碼內。

　msg

　下發信息的內容，70 個字，超長系統自動截取。

　Passagewayid 訂購產品編號 SendDatetime 發送時間，空為立即發送

　提交成功返回：成功條數 如：100

　成功提交 100 條。

　提交失敗返回狀態碼：

　-100：沒有訂購該產品 -101：帳號和密碼驗證失敗或是帳號被注銷； -102：手機號碼為空或含有不合法的手機號碼； -103：內容為空或含有非法字符； -104：賬號余額不足； -110：其他錯誤；

　2.2 彩信下行接口 接口定義：彩信下發。

　接口方法：

　public string SendMms(String username, String password, String phonelist, String msg, Int32 Passagewayid, String SendDatetime)

　 接口參數：

　參數名稱

　參數描述

　username

　系統分配的用戶帳號 password

　系統分配的用戶密碼 phonelist

　下發信息的手機號碼，多個手機號用半角逗號分隔，每個提交包控制在 100 個手機號碼內。

　msg

　1、大小控制在 50K 內； 2、目前只支持文字和圖片；圖片只支持 JPG（JPEG）、GIF格式； 3、一幀最多一張圖片和一個文本，或一幀只有圖片或一幀只有文字； 4、UTF-8 進行編碼 Passagewayid 訂購產品編號 SendDatetime 發送時間，空為立即發送 說明：

　1、 提交成功返回：成功條數 如：10

　成功提交 10 條。

　2、 Msg 采用 xml 形式 <?xml version="1.0" encoding="utf-16"?> <SRMMC xmlns:xsi="" xmlns:xsd="">

　 <Title>標題</Title>

　 <MMCFrameList>

　 <SRMMCFrame>

　 <IntervalDate>5</IntervalDate>

　 <Picture>[BASe64 編碼]</Picture>

　 <Sound>[BASe64 編碼]</ Sound >

　 <Content>文本</Content>

　 </SRMMCFrame>

　 </MMCFrameList> </SRMMC>

　MMCFrameList 下面可以由多個 SRMMCFrame 節點，每一個節點代表一幀。幀中只能有一個圖片 img 和一個文字 text 節點，圖片在上?；蛘邇H有一個圖片，或者僅有一段文字。

　圖片節點中的內容需要 base64 編碼。

　圖片的格式可以采用 gif 和 jpg 兩種。

　IntervalDate 屬性表示此彩信屏播放的秒數。

　最后需要整個 xml 包 UrlEncode 多 最多 10 幀。

　提交失敗返回狀態碼：

　-100：沒有訂購該產品 -101：帳號和密碼驗證失敗或是帳號被注銷； -102：手機號碼為空或含有不合法的手機號碼； -104：賬號余額不足 -105：xml 不合法 -106：彩信主題為空 -107：彩信超過 10 幀 -110：其他錯誤；

　2.5 帳戶余額查詢 接口定義：余額查詢 接口方法：

　public string GetBalance(String username, String password, String Passagewayid) 接口參數：

　參數名稱

　參數描述

　username

　系統分配的用戶帳號

　lluu password

　系統分配的用戶密碼

　563206 Passagewayid 查詢的訂購產品編號

　29

　狀態碼：

　賬號余額 -100: 用戶沒有訂購該產品 -101：帳號和密碼驗證失敗或是帳號被注銷； -110：其他錯誤；