移动商务无线接口协议

发布时间:2022-06-23 09:15:08   来源:党团工作    点击:   
字号:

 移动商务 无线接口协议

 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:其他错误;