电影兑票接口.doc

广东移动12580信息资讯互动中心12580电影频道兑票接口规范 V1.12012-03-512580电影频道接口规范 第 6 页 中数通信息有限公司声 明本文档所有权和解释权归中数通信息有限公司与广东移动通信有限责任公司共有，未经书面许可，不得复制或向第三方公开。修订历史日期修改内容版本号作者2012-03-05兑票同步接口1.0李奔2012-03-09增加兑票验证接口1.1李奔2012-03-12增加验证码同步接口1.2林永傍2012-03-131.3李奔文档目录修订历史2文档目录21.接口协议32.接口定义32.1.实时交互接口32.2.1.兑票同步接口32.2.2.兑票验证接口42.2.3.验证码同步接口43.返回代码及其描述54.校验信息生成61. 接口协议接口采用webservice形式，以XML格式传输数据2. 接口定义2.1. 实时交互接口2.2.1. 兑票同步接口接口名称updateExchangeTicketInfo参数名类型说明1userIdString接口访问账号2userPassString接口访问密码3orderIdString12580的订单ID4exchangeTicketString0表示兑票成功，其他字符无效4verifyInfoString校验信息返回值 0 XXXX XXXX XXXX 返回值描述XML标记类型描述ResultCodeString0:表示成功 非0数字:失败(具体数字表示错误代码)ErrorMsgString错误描述OrderId12580String12580的订单号ValidCodeString订单验证码2.2.2. 兑票验证接口接口名称exchangeVerification参数名类型说明1userIdString接口访问账号2userPassString接口访问密码3orderIdString12580的订单ID4verifyInfoString校验信息返回值 0 XXXX XXXX XXXX 返回值描述XML标记类型描述ResultCodeString0:表示成功 非0数字:失败(具体数字表示错误代码)ErrorMsgString错误描述OrderId12580String12580的订单号ExchangeStatusString兑票状态，0表示未兑票，1表示已兑票。2.2.3. 验证码同步接口接口名称synchronizeValidCode参数名类型说明1userIdString接口访问账号2userPassString接口访问密码3service_seqnum String序列号4orderIdString合作商的订单号4postValidCodeString机具验证码5manualValidCodeString手工验证码6verifyInfoString校验信息返回值 0 XXXX返回值描述XML标记类型描述ResultCodeString0:表示成功 非0数字:失败(具体数字表示错误代码)ErrorMsgString错误描述3.返回代码及其描述返回代码描述0成功12580001无效的接口调用12580002用户名错误12580003密码错误12580004校验信息错误12580005参数错误12580006内部查询错误12580007无相应记录错误12580008接口访问认证错误12580009接口访问错误12580010接口异常12580011排期不可售12580012合作商不存在12580013下订单失败12580014非中国移动号码12580015重发二维码失败12580016座位数量不符12580017赠票数量与实际优惠信息不符12580018订单金额错误12580100调用合作商接口超时4.校验信息生成校验信息算法如下：校验信息=转成小写(MD5(转成小写(参数1值+参数n值+密钥)1、 对于传非XML字符串为参数的接口 其中参数值是除访问账号、访问密码和校验信息外，按从左到右的顺序读取：遇到 参数值是数据型即转成字符型，遇到参数值是布尔型即转成”true”或”false”，遇到 参数值是数组型即取数组长度后转字符型2、 对于传XML字符串作为参数的接口 其中参数值是