跳到主要内容
博客

旅游API对比:比维度,而不是比供应商

Tekravel 编辑部
借助 AI 撰写

三个标签页里开着三家供应商的介绍材料。每一份都有一页长长的航司列表、一页酒店数量、一个沙箱环境、REST 和 JSON,以及一个技术支持邮箱。你做了一张对比表,在每个格子里打勾,最后结果是平局。按功能清单来做旅游 API 对比,通常就是这样收场的——而这恰恰是错误的结局。真正决定你接下来一年的差异,要等上线之后才会出现:供应商那边已经出票成功、你这边却超时的订单;没人能处理的退款;明明在列表里、却无法通过这条渠道出票的航司。

这篇文章写给需要做出选择、并且日后要为这个选择负责的开发者或技术负责人。它不给供应商排名。它提供的是:几条可以用来比较的维度,一份把时间花在失败场景上的试用计划,以及几个能迅速判断对方究竟是真正的供应商、还是在转卖别人供应商的问题。

为什么功能清单永远是平局

清单问的是"有没有这个能力"。几乎所有旅游 API 都能对几乎每一行回答"有",因为这些行本来就是按营销页面的口径写的:搜索、报价、预订、取消、出票、Webhook、沙箱。真正拉开差距的不是有没有 cancel,而是当你在起飞前十二小时、对一张已出票、带退改罚金、内容来自第三方渠道的订单调用它时,到底会发生什么。清单里没有这一栏。

还有第二个问题:填写清单的通常是供应商自己。你评分的是他们的自我介绍。

按维度而不是按供应商来做旅游 API 对比

把"供应商 × 功能"的表格换成由你自己打分的维度,依据是试用期间亲手收集的证据。下面这张表就是我们自己会用的。你可以调整各行的权重——只做酒店的业务对出票没那么在意——而且在采用之前,应该先和它争论一番。

维度功能清单问什么真正需要弄清楚什么敷衍的回答听起来像什么
覆盖面有多少航司和酒店?在你的市场里,有多少能通过这个 API 搜到、订到,并且能出票或确认一个没有拆分的大数字
深度有没有取消接口?按内容来源区分,哪些售后操作是自动化的:作废(Void)、退票、改签、更正姓名、附加服务"这些由我们的运营团队处理"
价格可靠性价格是实时的吗?预订时价格与搜索时价格不一致的频率有多高,API 如何告诉你"价格一直都是实时的"
错误语义错误有文档吗?错误是否告诉你订单处于什么状态,而不只是"失败了"所有失败都用同一个通用错误码
幂等性—重试一次预订请求,会不会生成第二个订单先是沉默,然后"我们没遇到过"
签约供应商—基于谁的合同、谁的 IATA 号、经由哪个 BSP 出票"我们和所有主流 GDS 都有合作"
接入与支持有沙箱吗?真实 PNR 卡住时谁来回应,多快回应一个工单表单,没有具体联系人

其中有两行在常见清单里根本找不到对应的问题。这并非偶然:恰恰是这两行出问题时代价最高,也恰恰是供应商的介绍材料最不会主动提起的。

覆盖面不等于深度

航司列表是所有介绍材料中最具误导性的一页。一份列着几百家承运人的名单,可能意味着好几种不同的情况,而只有一种是你真正想要的。

有些航司走 GDS,可以从预订到出票全流程完成。有些走 NDC 直连,搜索可能很好用,但订后服务——改期、部分退款、加购行李——对这家航司可能仍然要靠人工。有些是低成本航空,内容是从另一家分销商那里聚合来的:你能展示,有时也能预订,但票是通过你控制不了的路径送达的,时间你也没法向客户承诺。还有一些之所以出现在名单上,只是因为某次搜索响应里曾经返回过一个运价。

能展示却不能出票的航司,不算覆盖。对于面向消费者的产品,这比根本没有还糟:客户选了、付了钱,然后开始等。

酒店也是同样的结构,只是换了说法。酒店数量里既有供应商已经做过映射(Mapping)的,也有没做的;有上周缓存的静态价格,也有实时房态;有带释放期的配额(Allotment)房,也有自由销售(Free-sale)库存。请对方给出你所销售城市里可实时预订的数量,再问清楚他们自家多个上游之间的重复酒店如何合并——同一家酒店以三个价格出现三次,迟早会变成一张客服工单。

实用的测试范围要窄。写下占你大部分业务量的二十条航线和二十个酒店城市——比如上海—迪拜、北京—曼谷、广州—吉隆坡——请供应商在沙箱里把这些逐一跑通:搜索、报价、预订、出票或确认、取消。真有深度的供应商会二话不说地做完。只有那页幻灯片的供应商,会开始给你讲那页幻灯片。

试用期该测什么:异常路径,而不是正常路径

每个沙箱都能在一条清闲的航线上顺利订到一张经济舱单程票。沙箱本来就是为了展示这个而搭的。而你的真实流量会有相当一部分时间走在其他路径上,试用期是唯一一个代价低廉的观察时机。

用试用期把下面这份清单跑一遍,并把 API 的返回和事后实际发生的情况并排记录下来:

  • 搜索到预订之间价格变化。预订是直接失败、按新价格成功,还是返回一个要求确认的独立响应?你的界面能否不靠解析消息文本就区分这几种情况?
  • 报价过期。搜索后等待超过报价有效期再预订。过期是一个专门的错误,还是和"供应商不可用"共用同一个错误?
  • 预订时售罄。库存在报价和预订之间消失。订单处于什么状态?支付预授权有没有释放?
  • 超时后重试。发出预订请求,在响应返回前断开连接,然后再发一次。你现在手里是一个 PNR 还是两个?单是这一项测试,就比试用期其余所有测试加起来更能说明一家供应商。
  • 订单已生成,出票失败。API 能否报告一个已存在但未出票的 PNR?能否告诉你出票时限?
  • 部分失败。多间房的酒店请求,一间确认、一间没确认。往返行程的去程和回程来自不同来源。
  • 免费取消期之外的取消。罚金是在确认前就展示,还是到了账单上才发现?
  • 供应商宕机。问对方如何模拟。如果模拟不了,就问他们的客户是怎么摸清这种情况下的行为的。

每种情况你都在评两件事。第一,API 有没有如实告诉你订单状态?第二,你的代码能否不依赖人工阅读自由文本、直接根据这个状态采取行动?一个失败得清清楚楚的 API,比一个成功得含含糊糊的 API 更好相处。

关于机票这一侧,我们在机票预订 API 对接:文档没告诉你的那些事里写得更详细;关于如何为慢速酒店供应商设计客户端,可以看酒店房态那篇文章。两篇都很适合配合试用计划一起看。

识别"薄"聚合商的几个问题

聚合商本身没有问题。大多数旅游内容都是通过某个聚合商到达大多数销售方的。风险在于"薄"的那种:一层转卖另一层的 API,加上一点利润,却既不持有供应商合同,也没有运营团队。一旦出问题,答案得往上穿过两家公司,再传回来。

五个问题就能很快看清:

  1. 这笔订单的签约供应商是谁?它建立在谁和航司或酒店的合同之上?
  2. 用谁的 IATA 号、经由哪个 BSP 出票?如果回答是"合作方的",就追问:运价规则被违反时,ADM 由谁接收?
  3. 我调用取消时,你们那边发生了什么?是自动调用供应商,还是进入一个由人工处理的队列?
  4. 我能看到上游的原始错误吗?薄的中间层往往把所有失败压成一个错误码,因为它自己也没完全理解收到的错误。
  5. 真实订单卡住时我该找谁?他又该找谁?数一数中间隔了几层。

以上任何一个回答单独来看都不构成否决。只要合同写清楚了谁承担借记单,用合作方的 IATA 号也可以接受。关键是供应商能否回答得准确、迅速。在这里得到的含糊回答,就是日后在生产环境、在更糟糕的时间点你会得到的回答。

选错的代价

对接本身是便宜的部分。昂贵的部分在后面,而且不会出现在任何工作量估算里。

重复下单的缺陷,意味着客户被扣款两次,还有一个 PNR 需要你手动找出并取消,可能已经过了免费作废的时间窗口。上游已经成功、你这边却记录为失败的订单,意味着座位先被占住、随后被自动取消,而客户以为自己已经订好了。展示了却出不了票的航司,意味着退款、道歉和一个不再回来的客户。因供应商渠道违反运价规则而产生的 ADM,会落到持有这张票的一方头上——事先弄清楚那一方是不是你。

还有切换成本。你吸收的每一个供应商怪癖——一个状态码有两种含义、一个字段有时是字符串——最终都会沉淀进你的数据模型。两年之后,API 的选择就不再是一个一个迭代周期就能替换掉的对接,而是你订单表的形状。这才是现在要认真对比的真正原因。

我们自己的 API 在这个框架里处于什么位置

我们提供机票和酒店 API。接入从一次沟通开始,而不是自助申请一个密钥,有些开发者觉得这样慢;原因在于,正是在这次沟通中,上面这些问题会被双向提出——你需要哪些航线和城市,哪些内容你真正能出票或确认,订后由谁负责什么。如果你正在做对比,请带着这份清单来。旅游 API 页面就是这次沟通开始的地方。

无论最后选谁,都请依据试用记录,而不是介绍材料。介绍材料告诉你供应商想成为什么。异常路径告诉你它实际上是什么。

Tekravel 编辑部

旅游技术组

Tekravel 旅游技术组面向业内读者写作:代理商老板、票代批发商,以及为他们做对接的开发者。每篇文章在发布前都会在其所描述的平台上核对。