航班查询预订接口.doc

航班查询/预订接口 文档说明 阅读对象 南航国际票接口代理商开发人员 欣泓达接口服务平台开发人员 内容简介 本文档用来指导代理商技术人员来实现查询及预订国际航班的接口开发。请相关技术人员详细阅读本手册。 术语约定 缩略语 含义 XHD 深圳市欣泓达科技有限公司。 代理商 使用本接口并遵循本接口协议的合作方。 代理商ID 接口系统的身份标识，值唯一，不得更改。 航班 接口系统提供的可销售的国际航班信息。 占座 购买机票前需要先发送占座请求，返回成功后才可继续进行购买。 运价 接口系统提供的可销售的国际航班的机票价格、税费等。 密钥 代理商和XHD之间进行签名验证处理的密码，由XHD提供，代理商须妥善保管不得泄露。 接口功能 功能描述 代理商提供必要的参数请求接口，接口将处理结果数据以XML格式输出给代理商，由代理商对输出的XML数据进行解析并处理。 接口流程 接口协议 本协议基于HTTP，使用POST提交方式，用于WEB服务之间的通讯。每一个请求都由一个目的URL和相应参数组成。 请求参数 航班（价格）查询接口 接口URL http:// /pages/interface/ 字段名 可为空 签名字段 说明 spno N Y 代理商ID charset N Y 请求的编码，支持gbk和utf8两种编码类型。 mode N Y 请求类型，airline：航班查询；fare：运价查询；order：航班预订。 version N Y 接口版本号，值为1 。 times N Y 当前时间戳，如：1280741480。 sign N N 签名（见第3.3条说明） xml N Y 请求的XML数据，（见第3.2条说明） 请求的XML参数说明 注：如没有特别强调，以下XML标签项各值均不能为空，且保证数据真实有效。 查询航班请求 ?xml version=1.0 encoding=utf-8 ? page QUERY FROMCITYCAN/FROMCITY!-- 出发城市，城市的标准三字码。-- TOCITYSYD/TOCITY!-- 到达城市，城市的标准三字码。-- FROMDATFROMDATE!-- 出发日期，格式：YYYYMMDD。-- FLYTYPE1/FLYTYPE!-- 航线类型，1-单程 2-往返 -- /QUERY /page 查询运价请求 ?xml version=1.0 encoding=utf-8 ? page QUERY CABINTYPE1/CABINTYPE!-- 舱位类型，1-头等舱 2-公务舱 3-经济舱 -- !-- [[去程航班 -- GO !-- [[国际段航班 -- INTERNATIONAL FROMCITYCAN/FROMCITY!-- 出发城市，城市的标准三字码。-- TOCITYSYD/TOCITY!-- 到达城市，城市的标准三字码。-- FROMDATFROMDATE!-- 出发日期，格式：YYYYMMDD。以北京时间为准 -- CABINNAMEK/CABINNAME!-- 舱位编号，一位大写英文字母。-- /INTERNATIONAL !-- 国际段航班]] -- !-- [[国内段航班，如没有则值为：NULL，如：DOMESTICNULL/DOMESTIC -- DOMESTIC FROMCITYPEK/FROMCITY!-- 出发城市，城市的标准三字码。-- TOCITYCAN/TOCITY!-- 到达城市，城市的标准三字码。-- FROMDATFROMDATE!-- 出发日期，格式：YYYYMMDD。-- CABINNAMEH/CABINNAME!-- 舱位编号，一位大写英文字母。-- /DOMESTIC !-- 国内段航班]] -- /GO !-- 去程航班]] -- !-- [[回程航班，如没有则值为：NULL，如RENULL/RE -- RE !-- [[国际段航班 -- INTERNATIONAL FROMCITYSYD/FROMCITY!-- 出发城市，城市的标准三字码。-- TOCITYCAN/TOCITY!-- 到达城市，城市的标准三字码。-- FROMDATFROMDATE!--