Duffel 航班

通过 Duffel API 搜索、预订和管理覆盖 300 多家航空公司的航班。

环境配置

使用您的 Duffel API 访问令牌设置环境变量 DUFFEL_TOKEN。 访问 https://app.duffel.com → Developers → Access Tokens 获取令牌。 测试令牌（前缀为 duffel_test_）使用 sandbox 数据，账户余额无限制。

命令列表

搜索航班

python scripts/duffel.py search --from MIA --to LHR --date 2026-04-15
python scripts/duffel.py search --from MIA --to CDG --date 2026-03-15 --return-date 2026-03-22 --cabin business
python scripts/duffel.py search --from JFK --to LAX --date 2026-05-01 --nonstop --adults 2

支持的选项：--cabin economy|premium_economy|business|first、--nonstop、--adults N、--children N、--infants N、--sort price|duration、--max-results N、--json

搜索结果按序号编号。可在其他命令中使用该编号引用对应结果。

查看报价详情

python scripts/duffel.py offer 3

显示航段信息、行李政策、票价条款（是否可退改），以及可选附加服务。

预订航班

python scripts/duffel.py book 3 --pax "RIBEIRO/FABIO MR 1977-01-31 fabio@ribei.ro +13059159687 BR m"

乘机人格式：姓/名 称谓 出生日期 邮箱 电话 国籍 性别

• 称谓（TITLE）：MR、MRS、MS、MISS、DR
• 性别（GENDER）：m 或 f
• 多人出行：为每位乘客重复使用 --pax "..." 参数

支付使用 Duffel 账户余额。请前往 https://app.duffel.com 充值。

查询订单状态

python scripts/duffel.py order ord_0000XXXXX

取消订单

python scripts/duffel.py cancel ord_0000XXXXX           # 获取退票报价（显示应退金额）
python scripts/duffel.py cancel ord_0000XXXXX --confirm  # 执行取消操作

座位图

python scripts/duffel.py seatmap 3

机场/城市查询

python scripts/duffel.py places "new york"

典型工作流程

1. search → 浏览带编号的搜索结果
2. offer N → 查看详细信息、行李政策及票价条款
3. book N --pax "..." → 获取 PNR（旅客订座记录编号）
4. order → 核验预订状态
5. cancel → 如需取消订单

注意事项

• 报价具有时效性（通常约 20 分钟），过期后需重新搜索。
• 测试模式下：账户余额无限制，所有预订均归属虚构航空公司 “Duffel Airways”。
• 生产环境中：对接真实航空公司并生成真实机票，账户余额需预先充值。
• 所有命令均支持 --json 参数，用于输出原始 API 响应内容。
• 最近一次搜索结果保存至 /tmp/duffel-last-search.json，供索引引用。
• 如需了解 API 细节，请参阅 references/api-guide.md 和 references/booking-flow.md。