【B2C Webservice接口文档】是针对B2C(Business to Consumer)电子商务网站的Web服务接口规范,它提供了一种标准的方式,让商家能够与客户进行数据交互,例如处理订单、查询产品信息等。本接口文档主要涉及的是机票查询接口,通过这个接口,B2C网站可以获取到航班信息,方便用户预订机票。
接口APIVersion为1,说明了接口的通用参数,包括`account`(接口访问账号)、`md5`(权限验证的MD5加密串)和`xml`(接口请求参数,以XML文件格式的字符串)。在使用接口时,需要对密码进行MD5加密,然后结合请求参数的XML和加密后的密码再次进行MD5加密,以确保数据的安全性。
`websitecode`是接口依赖的网站的唯一标识,需要在Asms系统中获取。每个合作网站都有一个特定的网站代号,用于区分不同的业务来源。而`version`字段用于指定调用接口的版本,通常以文档首页标注的版本号为准,但某些接口可能会有特殊的版本说明。
**机票类接口**是B2CTicketWebService的一部分,其WSDL文件地址是http://asms系统IP地址:asms系统端口//service/B2CTicketWebService?wsdl。这个接口的主要功能是查询机票信息,具体接口名为`searchTicket`。请求XML格式包含了必需的参数,如`memberId`(会员ID),`airline`(航空公司),`arrivalCity`(到达城市三字码),`date`(出发日期),`departureCity`(出发城市三字码),`queryFlag`(查询类型,国内或国际),`clerk`(会员的扩展业务员编号),`websiteCode`(合作网站代号)以及`version`(版本号)。
接口调用示例中,返回的XML格式展示了查询结果,包括`resultCode`(反馈结果,1表示成功),`DataList`中包含具体的航班信息,如`Airlines`(航空公司),`Dpt`(出发城市三字码),`Arr`(到达城市三字码),`Date`(出发日期),以及每个航班的详细信息,如`Flight`节点下的`Carrier`(航空公司代码),`DptTime`(起飞时刻),`ArrTime`(到达时刻),`ETicket`(是否有电子客票),`Tax`(燃油税),`Yprice`(Y舱价格),`Price`(票价),`LowCode`(最低仓位),`LowStatus`(最低仓位状态),等等。
除此之外,接口还可能返回其他舱位信息(`OtherCw`),比如不同舱位的价格、政策等。这些详细的数据使得B2C网站能够为用户提供全面的航班选择,并根据用户的需要进行筛选和展示。
B2C Webservice接口文档定义了一个标准的机票查询流程,确保了数据传输的安全性和准确性,为B2C网站提供了一个高效、可靠的机票信息获取途径。对于开发人员来说,理解并正确使用这些接口是实现机票预订功能的关键步骤。同时,接口的设计也考虑到了未来可能的版本更新和扩展,以便适应业务需求的变化。