机票 API 集成

面向旅行社和 OTA 的机票 API：搜索、预订、出票

机票 API 让您的网站展示航空公司的实时运价，并生成真实的预订。本页介绍 API 调用的工作方式、机票内容的来源、上线前需要签署的协议，以及 PHPTRAVELS 如何把一个或多个机票 API 变成您自有域名上的完整预订引擎。

GDS、NDC 与批发商
从搜索到出票再到退票
现成连接器
您自己的 REST API

基本概念

机票 API 究竟做什么

机票 API 是航空公司、GDS 或批发商向旅游分销商开放的一组 Web 服务。您的系统发送请求（航线、日期和乘客），并收到带价格的报价。旅客选定后，后续调用会确认价格、创建预订并出票。

这些调用贯穿行程的整个生命周期。各供应商的命名不同，但每个机票 API 都涵盖同样的五个步骤，而 IATA 的 NDC 标准为它们定义了如今大多数供应商采用的消息名称。

API 只负责传输数据。搜索表单、结果页、支付、发票以及售后服务都属于预订平台的工作，这正是机票预订软件发挥作用的地方。

01
搜索AirShopping
发送出发地、目的地、日期、舱位和乘客，收到包含票价、税费、行李额和品牌运价的报价。
02
验价OfferPrice
向供应商再次确认所选报价。运价随时变化，这一调用确认旅客实际支付的金额。
03
预订OrderCreate
发送乘客姓名、联系方式和证件信息。供应商创建预订（PNR 或 NDC 订单）并锁定座位。
04
出票OrderChange · payment
付款后，预订以电子客票形式出票，每位乘客的每张航段乘机联都有对应的票号。
05
售后OrderRetrieve · OrderCancel
按照运价规则重新查询预订、改期、加购行李或座位、取消、作废或退票。

运价从哪里来

三类机票 API，三种销售方式

您能签约的每个机票 API 都属于以下三类之一。它们在内容、签约资格和出票方上各不相同，因此大多数旅行社最终会接入不止一种。

	GDS API	NDC API	批发商 API
是什么	Amadeus、Sabre 或 Travelport：一次连接即可获取数百家航空公司的公布运价。	航空公司通过 IATA NDC 标准提供的自有报价，可直连或经由聚合商接入。	以自有净价转售 GDS、NDC 和低成本航空内容的批发商。
内容	传统航空公司及其品牌运价；低成本航空的覆盖因 GDS 而异。	航空公司最丰富的报价：打包产品、附加服务和动态定价。	通常组合最广，包括低成本航空和私有运价。
签约资格	通常为持有 GDS 合同的认证旅行社（IATA、ARC 或当地同等资质）。	经航空公司或聚合商批准的旅行社；部分聚合商接受新企业。	大多数旅行社和 OTA，包括没有自有认证资质的企业。
出票	旅行社凭自身资质出票。	由航空公司出票；订单通过聚合商或 IATA BSP 结算。	批发商凭其资质代您出票。
结算	通过 BSP 或 ARC 结算；佣金和奖励取决于您的合同。	航空公司价格和费用；部分航空公司对非 NDC 预订加收附加费。	从预存款或授信额度中支付批发商净价，并加上您的加价。
PHPTRAVELS 已接入	Amadeus、Sabre、Travelport	Duffel	TBO、PKfare、Kiwi、AERTiCKET 等

不确定哪种适合？先接入批发商，第一天就能开卖；获得资质后再加 GDS；对于把最优报价放在 NDC 上的航空公司，再接入 NDC。旅行社 GDS 系统和NDC机票预订系统指南有更深入的介绍。

调用内部

每一步机票 API 传输哪些数据

以下是平台发送和接收数据的简化示意。真实供应商使用各自的字段名和长得多的消息；PHPTRAVELS 会把它们统一映射到同一个预订模型。

请求

 1POST /flights/search 2{ 3  "from": "DXB", "to": "LHR", 4  "date": "2026-11-14", 5  "cabin": "economy", 6  "passengers": { "adults": 2 } 7}

响应

 1{ 2  "offers": [{ 3    "id": "OF-7Q2K", 4    "carrier": "EK", "flight": "EK001", 5    "depart": "07:45", "arrive": "11:35", 6    "fare_family": "Standard", 7    "bags": "1 x 23 kg", 8    "total": { "amount": 1284.60, "currency": "USD" }, 9    "expires": "2026-10-09T12:20:00Z"10  }, …]11}

报价会过期。大多数供应商为每个报价设定时限，超时后必须重新搜索或验价。

请求

 1POST /flights/price 2{ "offer_id": "OF-7Q2K" }

响应

 1{ 2  "offer_id": "OF-7Q2K", 3  "available": true, 4  "total": { "amount": 1284.60, "currency": "USD" }, 5  "fare_rules": { 6    "change": "fee + fare difference", 7    "refund": "not refundable" 8  } 9}

如果运价有变，平台会在付款前显示新价格，而不是按旧价格预订。

请求

 1POST /flights/book 2{ 3  "offer_id": "OF-7Q2K", 4  "passengers": [{ 5    "type": "adult", 6    "given_name": "SARA", "surname": "KHAN", 7    "born": "1990-04-02", "passport": "…" 8  }, …], 9  "contact": { "email": "…", "phone": "…" }10}

响应

 1{ 2  "booking_ref": "6XK2PL", 3  "status": "held", 4  "ticket_time_limit": "2026-10-10T18:00:00Z" 5}

姓名必须与护照一致。许多航空公司对改名收费，或完全不允许改名。

请求

 1POST /flights/ticket 2{ "booking_ref": "6XK2PL", "payment": "…" }

响应

 1{ 2  "booking_ref": "6XK2PL", 3  "status": "ticketed", 4  "tickets": [ 5    { "passenger": 1, "number": "176-2400000001" }, 6    { "passenger": 2, "number": "176-2400000002" } 7  ] 8}