用途:通过 Duffel API 跨航空公司实时搜索航班报价,返回实时定价、舱位详情、行李信息和预订链接,支持单程、往返与多城市搜索,是现金票价的主要来源。
主要能力:按舱位(economy、premium_economy、business、first)查询;支持多乘客(成人、儿童、无座婴儿);可限制出发/到达时间段;可设 max_connections 为 0 只查直飞;返回总价、基础票价、税费、销售航司、报价过期时间、航段与经停、实际承运航司、行李额及退改签条件。
使用方式:需设置环境变量 DUFFEL_API_KEY_LIVE,令牌需具备 air.offer_requests.create 权限。基础地址 https://api.duffel.com,必须带请求头 Duffel-Version: v2(v1 已弃用),认证用 Authorization: Bearer $DUFFEL_API_KEY_LIVE,Content-Type: application/json。限流为每 60 秒 60 次请求。搜索用 POST /air/offer_requests?return_offers=true&supplier_timeout=15000,请求体 data 内含 slices、passengers、cabin_class 等。查询单个报价用 GET /air/offers/$OFFER_ID。
适用场景:需要实时可预订票价、按舱位与时间筛选、多城市行程比价,以及提取最便宜报价(可用 jq 排序取前 5)。
限制:报价通常 15 至 30 分钟过期,需检查 expires_at;须展示实际承运航司名称(美国 DOT 规定);supplier_timeout 应低于 HTTP 客户端超时;儿童乘客建议用 age 而非 type 以避免航司类型不匹配错误。资料未提供收费、价格与平台支持信息。