本商品提供以下API数据接口:
1. 航班实时起降时间查询:
通过输入航班日期、乘坐航班号,获取国内以及国际各大航班以下信息: 出发和到达城市 出发和到达机场代码 出发和到达航站楼名称 计划出发和到达时间 预计出发和到达时间 实际出发和到达时间 航班状态(到达、延误、取消等) 航班值机柜台 航班登机口 到达行李转盘、共享航班号码(目前只支持国内航班) 本接口支持过去七天和未来三天内的航班起降信息查询。
支持国内和国际航班查询 数据更新频率:根据航班正常或延误状态实时更新。API接口带有JSON数据校验能力,对于非法格式的航班号将会返回HTTP 500错误代码,此时不会计费。
2. 两地计划航班查询:
通过输入国内两地间机场IATA三字代码和日期,查询当天及未来三个月内两地间所有计划航班的预计出发和到达时间信息。本API目前只支持国内两地间的航班查询,用户可查询当天及未来三个月内国内两个机场之间当天所有的计划航班的预计出发和到达时间信息。失败的调用不计费。
支持查询国内两地间,以及部分国内-国际两地间所查询日期当天所有计划航班信息,失败的调用不计费。
3. 机场出发时刻表:
通过输入所查询机场三位IATA或四位ICAO代码,获取该机场当前所有计划出发的航班目的地和计划出发、预计到达时间等信息。覆盖全球所有主要机场,数据实时更新。每次查询最多返回15条数据,如需要更多数据请在请求参数中指定startOffset起始偏移量的数值。默认startOffset为0时,返回所查询机场当前最近的15条计划出发航班的记录。
4. 机场到达时刻表:
通过输入机场三位IATA代码或四位ICAO代码,返回正前往所查询机场所有航班的实际出发和预计到达时间信息。覆盖全球所有主要机场,数据实时更新。每次查询最多返回15条数据,如需要更多数据请在请求参数中指定startOffset起始偏移量的数值。默认startOffset为0时,返回所查询机场当前最近的15条计划出发航班的记录。
备注:
1. 如用户需要其他类型航班数据,例如航班实际出发到达时间实时推送、国际两地间当天所有计划航班查询等,请优先联系客服热线电话。
2. 航班实时起降信息查询API根据实时数据的不同获取情况,部分航班可能会缺少延误率、航班状态、行李转盘、登机口、值机柜台这几个字段,用户需要在代码中判断这几个字段是否存在,以避免程序出错。但计划/预计/实际 的 起飞/到达时间等几个字段一定会有。API接口带有JSON数据校验能力,对于非法格式的航班号将会返回HTTP 500错误代码,此时不会计费。
3. 对于共享航班号,航班实时起降时间查询API的返回结果中会列出所有国内航班当天与当前被查询航班共享代码的航班
4. 对于分段的经停航班数据,航班实时起降时间查询API的返回结果中会按序返回查询结果,总里程的相关信息存放在返回结果数组第一个元素中,以下分别为按序排列的第一段里程、第二段里程数据。总里程的实际起飞和到达时间会根据分段里程数据的内容相应实时更新。
API调用方法说明:
1. 航班实时起降时间查询:
API请求必须使用POST方法
请求头部必须包含"Content-Type: application/json"信息
在API请求的body中填入以下JSON信息,其中serviceID, actionName字段的内容固定为“urn:cdif-io:serviceID:航班信息查询服务”和“起降时间查询”,input字段的内容填入要查询的航班号(flightNo)和查询日期(date)。
范例如下:
{ "serviceID": "urn:cdif-io:serviceID:航班信息查询服务",
"actionName": "起降时间查询",
"input": {
"flightNo": "SC4602",
"date": "2017-05-20"
}
}
以上flightNo字段为字符串类型,其内容为航空公司的IATA代码(暂时不支持三位ICAO代码)加上航班编号,例如MU5077, SC4602等,字符串中不能包含空格,中文或特殊字符。date字段为字符串类型,格式为YYYY-MM-DD。
API调用请求的完整curl范例如下:
curl -H 'Authorization:APPCODE 你自己的AppCode' -H 'Content-Type: application/json' -X POST -d '{"serviceID":"urn:cdif-io:serviceID:航班信息查询服务","actionName":"起降时间查询","input":{"flightNo":"SC4602","date":"2017-05-20"}}' http://apemesh.market.alicloudapi.com/devices/055a2472-fd32-595f-add1-726f9987d4d3/invoke-action
2. 两地计划航班查询
API请求必须使用POST方法。
请求头部必须包含"Content-Type: application/json"信息。
在API请求的body中填入以下JSON信息,其中serviceID, actionName字段的内容固定为“urn:cdif-io:serviceID:航班信息查询服务”和“航班查询”,input对象中填入以下字段内容: 出发城市机场三位字母代码(depCity) 到达城市机场三位字母代码(arrCity) 查询日期(date)
范例如下:
{ "serviceID": "urn:cdif-io:serviceID:航班信息查询服务",
"actionName": "航班查询",
"input": {
"depCity": "SZX",
"arrCity": "PVG",
"date": "2017-11-07"
}
}
以上depCity, arrCity和date字段的内容都是字符串类型,其格式为出发城市机场三位IATA字母代码、到达城市机场三位IATA字母代码(暂时不支持四位ICAO机场代码)、和YYYY-MM-DD格式的日期值
API调用请求的完整curl范例如下:
curl -H 'Authorization:APPCODE 你自己的AppCode' -H 'Content-Type: application/json' -X POST -d '{"serviceID":"urn:cdif-io:serviceID:航班信息查询服务","actionName":"航班查询","input":{"depCity":"SZX","depCity":"PVG","date":"2017-11-07"}}' http://apemesh.market.alicloudapi.com/devices/055a2472-fd32-595f-add1-726f9987d4d/invoke-action
3. 机场出发时刻表:
API请求必须使用POST方法
请求头部必须包含"Content-Type: application/json"信息
在API请求的body中填入以下JSON信息,其中serviceID, actionName字段的内容固定为“urn:apemesh-com:serviceID:机场时刻表服务”和“计划出发航班列表”,input字段的内容填入要查询的机场代码(airport)和查询数据起始偏移量(startOffset)。
范例如下:
{
"serviceID": "urn:apemesh-com:serviceID:机场时刻表服务",
"actionName": "计划出发航班列表",
"input": {
"airport": "WUH",
"startOffset": 0
}
}
以上airport字段为字符串类型,其内容为所查询机场的三位IATA代码或四位ICAO代码,字符串中不能包含空格,中文或特殊字符。startOffset字段为number类型。
API调用请求的完整curl范例如下:
curl -H 'Authorization:APPCODE 你自己的AppCode' -H 'Content-Type: application/json' -X POST -d '{"serviceID":"urn:apemesh-com:serviceID:机场时刻表服务","actionName":"计划出发航班列表","input":{"airport":"PVG","startOffset":0}}' http://apemesh.market.alicloudapi.com/airport-scheduled-departure/invoke-action
4. 机场到达时刻表:
API请求必须使用POST方法
请求头部必须包含"Content-Type: application/json"信息
在API请求的body中填入以下JSON信息,其中serviceID, actionName字段的内容固定为“urn:apemesh-com:serviceID:机场时刻表服务”和“正前往航班列表”,input字段的内容填入要查询的机场代码(airport)和查询数据起始偏移量(startOffset)。
范例如下:
{
"serviceID": "urn:apemesh-com:serviceID:机场时刻表服务",
"actionName": "正前往航班列表",
"input": {
"airport": "WUH",
"startOffset": 0
}
}
以上airport字段为字符串类型,其内容为所查询机场的三位IATA代码或四位ICAO代码,字符串中不能包含空格,中文或特殊字符。startOffset字段为number类型。
API调用请求的完整curl范例如下:
curl -H 'Authorization:APPCODE 你自己的AppCode' -H 'Content-Type: application/json' -X POST -d '{"serviceID":"urn:apemesh-com:serviceID:机场时刻表服务","actionName":"正前往航班列表","input":{"airport":"PVG","startOffset":0}}' http://apemesh.market.alicloudapi.com/airport-scheduled-arrival/invoke-action