机票价格 API:你看到的数字还不是票价

演示一切顺利。开发人员把机票价格 API接进一个“最便宜出行日”的日历,格子里填满了数字,会议室里人人满意。接着第一位真实客户选好日期,发现结果页上的金额比支付页低,截图发给了客服。系统没有出错。API 做了被要求的事:回答了一个关于价格的问题,而网站把这个回答当成了承诺。
价格是一份记忆很短的报价
航空运价不是贴在座位上的固定标签。它是一个随座位售出而开放或关闭的舱位等级,数字会随乘客构成、具体航班、涉及机场的税费以及报价币种而变。价格响应只是某个时刻、针对一组输入拍下的快照。把它当作关于过去的事实,你会做出正确的东西;把它当作关于现在的事实,你就要花一个月去处理退款。
所以对开发者来说,有用的问题从来不只是价格是多少,而是:这是哪一种价格、有多旧、如果它错了系统会怎么做。
三个都被叫作“价格”的数字
多数供应商会在文档的某处返回这三者,常常用同一个字段名。从第一天起就在自己的数据模型里把它们分开。
| 状态 | 来源 | 新鲜度 | 能卖吗? | 展示什么 |
|---|---|---|---|---|
| 浏览价 | 缓存或聚合搜索,为速度和覆盖面设计 | 可能已过期,也不是按你的乘客算的 | 不能 | “起”字样,并注明可能变动 |
| 已报价的报价单 | 针对确切行程、乘客类型和运价的实时请求 | 调用时是新的,带有有效期或重新报价信号 | 能,直到过期 | 总价、税费明细、运价规则 |
| 实际出票金额 | 下单时航司或出票系统真正收取的金额 | 最终结果 | 已售出 | 收据,并与报价单对账 |
浏览价让日历和“最低价起”徽标成为可能,做出来很有价值。但它和第二行并不是同一个对象。错误在于只有一个叫 price 的字段,三者都往里灌。
落到实处,就是代码里有三种类型或三张表,而不是一个带标记的类型。浏览价可以有小误差,因为它只是邀请用户点击。已报价的报价单是你即将以自己名义作出的承诺,所以要连同获取时间、产生它的输入,以及供应商下单时要求回传的标识一起保存。实际出票金额属于会计。当客服问为什么客户付的数字和邮件里不同,答案就在行与行之间的差距里,只有三者都留存了你才读得出来。
价格响应必须带上什么
光有一个数字,撑不起一个结账流程。读供应商的示例响应时,留意下面这些,并对任何以自由文本形式出现的内容保持怀疑。
- 币种,写在响应里,而不是从你的账户推断。
- 基础运价与税费分开,这样才能展示明细,也不会让税费变动看起来像运价变动。
- 价格所对应的乘客类型。成人价乘以三不是家庭票价。
- 以结构化数据给出的运价规则与行李,因为它们决定便宜的选项对你的客户是否真的更便宜。
- 有效期或重新报价信号:一个时间戳,或明确说明下单前必须重新报价。
最后一项最常被跳过。如果响应里没有任何内容说明报价能存活多久,你就是在猜,而这个猜测发生在生产环境里。
在下单之前重新报价,而不是之后
最稳妥的节奏里有一条规则。搜索用来浏览。客户选定行程后,针对这条行程和这些乘客请求一份实时报价。把这个总价展示给客户。然后才创建订单。如果实时价格和结果页不同,就在客户付款之前用明白的话告诉他们,而不是付款之后。
跳过中间这一步,你就继承了差额。要么多收了客户所见的金额,在支付页丢掉这笔生意;要么按较低的数字兑现,差额从自己的利润里出。小型旅行社可以吸收几次,但不能把它当作设计。
对接之前,用书面方式问清这些
文档描述的是顺利的路径。让你花钱的行为藏在一份简短问题清单的答案里,这些答案最好留在邮件里,而不是电话里。
- 搜索响应里的价格是实时的还是缓存的,响应本身有没有注明?
- 针对确切行程是否有单独的定价调用,下单前是否必须调用?
- 下单时如果价格变了会怎样:拒绝、响应中给出新价格,还是悄悄按新金额出票?
- 税费和承运人附加费如何列示,在定价与出票之间是否会变化?
- 价格以什么币种计算,客户看到另一种币种时在哪里换算?
- 一份已报价的报价单有效多久,你如何得知?
回答精确的供应商是认真想过结账环节的。回答“永远是最新的”的供应商,没有给你任何可以测试的东西。如果你无法亲自试验这种行为,就有理由先换个角度审视整个体系,再在上面搭建。
出错的代价
它很少大张旗鼓地失败。它表现为支付环节一次小小的下滑,没人把它归因于价格;表现为以“价格变了”开头的客服工单;表现为一位信任结果页、如今不再信任的客户。员工最后只好在出票前手动复核运价。终于有人提议为稳妥起见把价格往上取整,于是网站在用户比价的那个页面上变贵了。这每一笔,都是对一个本来在一开始很便宜就能做对的决定所缴的税。
这个平台的位置
平台提供航班和酒店 API,按租户分别开通。接入从一次沟通开始,而不是自助获取密钥,所以没有一个表单能直接把令牌和限额表交给你。这里不公布延迟、覆盖面或运价数量,因为一个我们无法说明如何验证的数字,不值得印出来。你可以做的是,带着上面的问题进入那次沟通,要求查看针对已报价报价单的响应,而不仅仅是搜索的响应。如果你正处于这一步,起点是旅行 API 页面。