旅游圈度假线路产品标准api接口1.0.8.doc

旅游圈度假线路产品标准API接口1.0.8 更新记录 版本号 更新内容 1.0.1 获取所有产品信息示例更新 1.0.2 Product增加字段：TeamCode、HotelStandard、HotelStandardOtherDesc、TrafficType、TrafficTypeOtherDesc、ProductLevel、ProductType、TravelType、SecondLevelArea、ThirdLevelAreas、FourthLevelAreas 1.0.4 1.1获取所有产品信息接口更新。优化全量产品XML ，根据产品数量自动拆分为多个xml文件，提高单次访问解析速度，减少通信失败。具体解释见接口描述。 1.3推送最近更新的产品ID接口，接口推送时间描述更新。 1.0.5 把错误的测试地址更新为正确的，由更新为 1.0.6 1.2根据产品ID获取产品信息或班期信息，更新正确的响应报文示例名字，由 获取产品信息请求报文（班期信息）.xml更新为 获取产品信息响应报文（班期信息）.xml，该XML示例是响应报文，之前写成了请求报文。 1.0.7 1.1获取所有产品信息接口，调用接口地址描述更新。 1.0.8 1.2根据产品ID获取产品信息或班期信息接口。父节点为ProductCabinType增加子节点StockCount；更新xml示例：获取产品信息响应报文（产品信息）.xml；ProductSchedule下子节点描述更新。 目 录 1. 产品管理 2 1.1获取所有产品信息 2 1.2根据产品ID获取产品信息或班期信息 3 1.3推送最近更新的产品ID 6 备注说明 6 产品管理 1.1获取所有产品信息 1.1.1 接口说明 通讯协议 HTTP GET 调用接口 http://{WebServerPath}/BusinessXml/{SecretKey}/Product/{xmlFileName} 注：{xmlFileName}为具体的某个XML文件，详情见下方接口描述 旅游圈预先将所有产品信息生成到XML文件中，首先需要获取Total.xml文件，解析此文件中XmlFileCount，XmlFileCount为有多少个产品信息Xml文件。然后获取产品信息，获取产品信息从Detail1.xml开始一直到DetailXmlFileCount.xml。 比如：从Total.xml文件解析到XmlFileCount为5，那么获取产品信息的时候需要获取5个Xml文件，分别为：Detail1.xml、Detail2.xml、Detail3.xml、Detail4.xml、Detail5.xml 注意：这些xml文件系统会一天更新一次。 1.1.2 响应Xml报文字段及示例 Total.xml 父节点 字段名 数据类型 描述 必填 ProductRoot XmlFileCount Int 总Xml文件个数 Y ProductCount Int 总产品数量 Y Detail1.xml 父节点 字段名 数据类型 描述 必填 ProductRoot TotalCount Int 当前Xml文件中总产品数量 Y Products Array 产品信息数组 Y Products Product ArrayItem 单个产品信息，具体子节点见：根据产品ID获取产品信息或班期信息接口的响应报文描述，父节点为Product。 Y 1.1.2 Xml示例 1.1.3 代码示例（C#） 1.2根据产品ID获取产品信息或班期信息 1.2.1 接口说明 通讯协议 HTTP POST 调用接口 http://{WebServerPath}/BusinessOpenAPIService.svc/ GetProduct 1.2.2 请求Xml报文字段及示例 父节点 字段名 数据类型 描述 必填 GetProductRequest SecretKey string 密钥 Y ProductIDs Array 产品ID数组（子节点描述见下方）, 一次最多查询50个产品，超过50个产品请进行分页查询。如果提交的数据中超过50个产品，将直接返回错误。 Y Type int 获取产品信息类型。0获取产品信息，1获取班期信息，默认为0 Y ProductIDs ProductID string 产品ID Y 示例： ?xml version=1.0 encoding=utf-8? GetProductRequest xmlns:xsi=/2001/XMLSchema-instance xmlns:xsd=/2001/XMLSchema SecretKeyC967632