机票价格聚合查询API设计

技术 PRO 作者：李蓉蓉 2025-03-10 21:45

该 API 用于聚合查询不同机票销售平台的价格信息，帮助用户找到最便宜的机票选项。用户可以通过指定必要的查询参数（日期、出发地、到达地）以及可选的筛选条件来获取符合条件的机票价格信息。

请求方法和路径

方法：GET

路径：/flights

请求参数

必要参数

参数名	类型	描述
date	string	出发日期，格式为 YYYY-MM-DD
origin	string	出发地城市或机场代码
destination	string	到达地城市或机场代码

可选参数

参数名	类型	描述
date_range	string	时间范围，格式为 start_date,end_date
origin_airport	string	出发机场代码
destination_airport	string	到达机场代码
flight_number	string	航班号
airline	string	航空公司代码或名称
cabin_class	string	舱位等级，如 economy, business, first

响应格式

返回的响应将是一个 JSON 对象，包含查询到的机票信息列表。每个机票信息对象包含以下字段：

字段名	类型	描述
price	number	机票价格
departure_time	string	出发时间，格式为 YYYY-MM-DDTHH:mm:ss
arrival_time	string	到达时间，格式为 YYYY-MM-DDTHH:mm:ss
origin	string	出发地
destination	string	到达地
origin_airport	string	出发机场代码
destination_airport	string	到达机场代码
flight_number	string	航班号
airline	string	航空公司
cabin_class	string	舱位等级

示例请求和响应

示例请求

http
GET /flights?date=2023-10-01&origin=PEK&destination=SHA&date_range=2023-10-01,2023-10-07&origin_airport=PEK&destination_airport=SHA&flight_number=CA1234&airline=AirChina&cabin_class=economy

示例响应

JSON
{ "flights": [ { "price": 850.50, "departure_time": "2023-10-01T08:00:00", "arrival_time": "2023-10-01T10:30:00", "origin": "北京", "destination": "上海", "origin_airport": "PEK", "destination_airport": "SHA", "flight_number": "CA1234", "airline": "AirChina", "cabin_class": "economy" }, { "price": 900.00, "departure_time": "2023-10-01T09:15:00", "arrival_time": "2023-10-01T11:45:00", "origin": "北京", "destination": "上海", "origin_airport": "PEK", "destination_airport": "SHA", "flight_number": "MU5102", "airline": "ChinaEastern", "cabin_class": "economy" } ]}