移动商务 无线接口协议
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 节点,图片在上。或者仅有一个图片,或者仅有一段文字。
图片节点中的内容需要 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:其他错误;