用途：通过 Duffel API 完成机票与酒店（Stays）的搜索和预订。适用于用户提到 Duffel、订机票、航班搜索、航空公司 API、酒店预订等场景。
认证：所有请求需在 Authorization 头使用 Bearer 方案传入访问令牌，并附带 Duffel-Version 头固定 API 版本。示例：Authorization: Bearer $DUFFEL_TOKEN 与 Duffel-Version: v2。令牌以 duffel_test_ 开头为测试模式（沙箱航司、假卡），以 duffel_live_ 开头为实时模式，两者不可混用。官方文档：https://duffel.com/docs/api
航班流程：创建报价请求（搜索）→ 选择报价 → 创建订单 → 可选取消。搜索时向 /air/offer_requests 提交乘客、航段（origin/destination 用 IATA 三字码）、舱位等；响应含 offer_request.id 与首批报价。可用 /air/offers 分页、排序（total_amount 或 total_duration）、过滤（max_connections 等）。获取单个报价时加 return_available_services=true 可含行李、座位等附加服务。创建订单向 /air/orders 提交 selected_offers、乘客信息与 payments（通常 type 为 balance，金额与币种须与报价 total_amount/total_currency 完全一致）。取消为两步：先创建待处理取消以预览退款，再确认。
酒店流程：搜索 → 获取全部房价 → 创建报价 → 创建预订。向 /stays/search 提交房间数、位置（坐标或 accommodation.id）、入住/退房日期与客人；结果含 search_result_id。用 /stays/search_results/<id>/actions/fetch_all_rates 获取全部房价，取 rate.id 创建报价（/stays/quotes），报价有效期仅数分钟，随后尽快向 /stays/bookings 创建预订。支持获取、列出与取消预订。
辅助资源：列出航司、查询机型、通过 /places/suggestions 用城市名或机场代码查询地点。
限制与注意：必须发送 Duffel-Version: v2，否则请求被拒；测试与实时令牌数据互不可见；报价数分钟后过期需重新搜索；订单支付金额须与报价完全匹配；酒店报价数分钟内过期；取消为两步操作。常见状态码包括 200、201、400、401、404、422、429 与 5xx。故障排查可运行 zero doctor check-connector --env-name DUFFEL_TOKEN 或 zero doctor check-connector --url https://api.duffel.com/air/airlines --method GET。