航班动态HTTP数据接口说明V2.0.doc

一、查询当日数据
1， 查询参数：

参数
描述
Uid
用户注册码，10位，需要向飞友网索取
vNum
航班号，格式：CA1234
vOrg
出发地，格式：三字码/汉字/拼音（注：输入上海默认为上海虹桥，查询浦东航班请输入上海浦东）
vDst
目的地，格式：三字码/汉字/拼音（注：输入上海默认为上海虹桥，查询浦东航班请输入上海浦东）

2， 接口地址：

3， 调用方式：
Http GET提交

4，功能描述：

（1）查询当日航班号vNum的动态信息
所需参数：Uid，vNum
查询成功则返回XML格式如下：
<?xml version="1.0" encoding="gb2312" ?>
- <Flight>
  <FlightDate>2010-2-4</FlightDate>
  <FlightNote>成功</FlightNote>
  <FlightNullCode>0</FlightNullCode>
- <FlightInfo><!-- 多个航班存在多个FlightInfo-à
  <FlightCompany>山东航空公司</FlightCompany>
  <FlightNo>SC4919</FlightNo>
  <FlightDepcode>TNA</FlightDepcode>
  <FlightArrcode>HFE</FlightArrcode>
  <FlightDep>济南</FlightDep>
  <FlightArr>合肥</FlightArr>
  <FlightDeptimeReady>15:45</FlightDeptimeReady>
  <FlightArrtimeReady>16:45</FlightArrtimeReady>
  <FlightDeptime>false</FlightDeptime>
  <FlightArrtime>false</FlightArrtime>
  <FlightState>计划</FlightState>
  <FlightTerminal>false</FlightTerminal>
  <FlightHTerminal>false</FlightHTerminal>
  </FlightInfo>
  <FlightCompany>山东航空公司</FlightCompany>
  <FlightNo>SC4919</FlightNo>
  <FlightDepcode>HFE</FlightDepcode>
  <FlightArrcode>KWE</FlightArrcode>
  <FlightDep>合肥</FlightDep>
  <FlightArr>贵阳</FlightArr>
  <FlightDeptimeReady>17:20</FlightDeptimeReady>
  <FlightArrtimeReady>19:20</FlightArrtimeReady>
  <FlightDeptime>false</FlightDeptime>
  <FlightArrtime>false</FlightArrtime>
  <FlightState>计划</FlightState>
  <FlightTerminal>false</FlightTerminal>
  <FlightHTerminal>false</FlightHTerminal>
  </FlightInfo>
  </Flight>

未成功返回XML格式如下：
<?xml version="1.0" encoding="gb2312" ?>
- <Flight>
<FlightDate>2009-2-3</FlightDate>
  <FlightNote>今日无该航班</FlightNote>
  <FlightNullCode>1</FlightNullCode>
</Flight>

（2）查询当日航线vOrg至vDst的航班动态信息
所需参数：Uid，vOrg，vDst
成功则返回XML格式如下：
<?xml version="1.0" encoding="gb2312" ?>
- <Flight>
  <FlightDate>2010-2-4</FlightDate>
  <FlightNote>成功</FlightNote>
  <FlightNullCode>0</FlightNullCode>
- <FlightInfo><!-- 多个航班存在多个FlightInfo-à
  <FlightCompany>中国国际航空公司</FlightCompany>
  <FlightNo>CA4963</FlightNo>
  <FlightDepcode>TNA</FlightDepcode>
  <FlightArrcode>KWE</FlightArrcode>
  <FlightDep>济南</FlightDep>
  <FlightArr>贵阳</FlightArr>
  <FlightDeptimeReady>07:45</FlightDeptimeReady>
  <FlightArrtimeReady>11:48</FlightArrtimeReady>
  <FlightDeptime>07:59</FlightDeptime>
  <FlightArrtime>11:57</FlightArrtime>
  <FlightState>到达</FlightState>
  <FlightTerminal>false</FlightTerminal>
  <FlightHTerminal>false</FlightHTerminal>
  </FlightInfo>
  <FlightCompany>中国南方航空公司</FlightCompany>
  <FlightNo>CZ3792</FlightNo>
  <FlightDepcode>TNA</FlightDepcode>
  <FlightArrcode>KWE</FlightArrcode>
  <FlightDep>济南</FlightDep>
  <FlightArr>贵阳</FlightArr>
  <FlightDeptimeReady>17:10</FlightDeptimeReady>
  <FlightArrtimeReady>21:00</FlightArrtimeReady>
  <FlightDeptime>false</FlightDeptime>
  <FlightArrtime>false</FlightArrtime>
  <FlightState>计划</FlightState>
  <FlightTerminal>false</FlightTerminal>
  <FlightHTerminal>false</FlightHTerminal>
  </FlightInfo>
  </Flight>

未成功则返回XML格式如下：
<?xml version="1.0" encoding="gb2312" ?>
- <Flight>
<FlightDate>2009-2-4</FlightDate>
  <FlightNote>今日无该航线</FlightNote>
  <FlightNullCode>1</FlightNullCode>
</Flight>

二、其他返回情况
（1）由于账号错误，返回XML格式如下：
  <?xml version="1.0" encoding="gb2312" ?>
- <Flight>
  <FlightNote>请联系管理员</FlightNote>
  <FlightNullCode>2</FlightNullCode>
  </Flight>

（2）由于查询参数错误，返回XML格式如下：
  <?xml version="1.0" encoding="gb2312" ?>
- <Flight>
  <FlightDate>2010-2-4</FlightDate>
  <FlightNote>查询参数错误</FlightNote>
  <FlightNullCode>1</FlightNullCode>
  </Flight>

三、XML数据反馈各节点说明
节点
描述
FlightDate
查询航班日期
FlightNote
查询描述
FlightNullCode
查询数据是否为空，1为空，0为有数据
FlightCompany
航空公司
FlightNo
航班号
FlightDepcode
出发地三字码
FlightArrcode
目的地三字码
FlightDep
出发地城市名（汉字）
FlightArr
目的地城市名（汉字）
FlightDeptimeReady
航班预计起飞时间，值为false代表空值
FlightArrtimeReady
航班预计到达时间，值为false代表空值
FlightDeptime
航班起飞时间，值为false代表空值
FlightArrtime
航班到达时间，值为false代表空值
FlightTerminal
接机楼，值为false代表空值
FlightHTerminal
登机楼，值为false代表空值
FlightState
航班当前状态，几种状态：起飞，计划，到达，延误，取消，备降

３