移動(dòng)商務(wù) 無(wú)線(xiàn)接口協(xié)議
201 11 1- -7 7
1 、 概述 1)、通訊協(xié)議是 HTTP 的 webservice(POST 方式提交內容)。
2)、請求應答過(guò)程中使用的中文編碼格式為 UTF-8。
3)、應答為狀態(tài)碼,每個(gè)接口下定義具體的狀態(tài)碼 4)接口地址:
?WSDL
2 、接口定義 2.1 短信下行接口 接口定義:短信下發(fā)。
接口方法:
public string SendSms(String username, String password, String phonelist, String msg, Int32 Passagewayid, String SendDatetime) 接口參數:
參數名稱(chēng)
參數描述
username
系統分配的用戶(hù)帳號 password
系統分配的用戶(hù)密碼 phonelist
下發(fā)信息的手機號碼,多個(gè)手機號用半角逗號分隔,每個(gè)提交包控制在 100 個(gè)手機號碼內。
msg
下發(fā)信息的內容,70 個(gè)字,超長(cháng)系統自動(dòng)截取。
Passagewayid 訂購產(chǎn)品編號 SendDatetime 發(fā)送時(shí)間,空為立即發(fā)送
提交成功返回:成功條數 如:100
成功提交 100 條。
提交失敗返回狀態(tài)碼:
-100:沒(méi)有訂購該產(chǎn)品 -101:帳號和密碼驗證失敗或是帳號被注銷(xiāo); -102:手機號碼為空或含有不合法的手機號碼; -103:內容為空或含有非法字符; -104:賬號余額不足; -110:其他錯誤;
2.2 彩信下行接口 接口定義:彩信下發(fā)。
接口方法:
public string SendMms(String username, String password, String phonelist, String msg, Int32 Passagewayid, String SendDatetime)
接口參數:
參數名稱(chēng)
參數描述
username
系統分配的用戶(hù)帳號 password
系統分配的用戶(hù)密碼 phonelist
下發(fā)信息的手機號碼,多個(gè)手機號用半角逗號分隔,每個(gè)提交包控制在 100 個(gè)手機號碼內。
msg
1、大小控制在 50K 內; 2、目前只支持文字和圖片;圖片只支持 JPG(JPEG)、GIF格式; 3、一幀最多一張圖片和一個(gè)文本,或一幀只有圖片或一幀只有文字; 4、UTF-8 進(jìn)行編碼 Passagewayid 訂購產(chǎn)品編號 SendDatetime 發(fā)送時(shí)間,空為立即發(fā)送 說(shuō)明:
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 下面可以由多個(gè) SRMMCFrame 節點(diǎn),每一個(gè)節點(diǎn)代表一幀。幀中只能有一個(gè)圖片 img 和一個(gè)文字 text 節點(diǎn),圖片在上?;蛘邇H有一個(gè)圖片,或者僅有一段文字。
圖片節點(diǎn)中的內容需要 base64 編碼。
圖片的格式可以采用 gif 和 jpg 兩種。
IntervalDate 屬性表示此彩信屏播放的秒數。
最后需要整個(gè) xml 包 UrlEncode 多 最多 10 幀。
提交失敗返回狀態(tài)碼:
-100:沒(méi)有訂購該產(chǎn)品 -101:帳號和密碼驗證失敗或是帳號被注銷(xiāo); -102:手機號碼為空或含有不合法的手機號碼; -104:賬號余額不足 -105:xml 不合法 -106:彩信主題為空 -107:彩信超過(guò) 10 幀 -110:其他錯誤;
2.5 帳戶(hù)余額查詢(xún) 接口定義:余額查詢(xún) 接口方法:
public string GetBalance(String username, String password, String Passagewayid) 接口參數:
參數名稱(chēng)
參數描述
username
系統分配的用戶(hù)帳號
lluu password
系統分配的用戶(hù)密碼
563206 Passagewayid 查詢(xún)的訂購產(chǎn)品編號
29
狀態(tài)碼:
賬號余額 -100: 用戶(hù)沒(méi)有訂購該產(chǎn)品 -101:帳號和密碼驗證失敗或是帳號被注銷(xiāo); -110:其他錯誤;