最佳机票预订API:先说清你要做什么产品

需求写的是:找出最佳机票预订API。于是你打开三个对比页面,它们把同样的几个名字排成三种顺序,每页都有一张打满勾的功能表。到第三页你才发现,没有一页问过:搜索结果返回之后,客户会发生什么?
这个被漏掉的问题就是全部答案。对一个把访客送去航司官网的页面来说,最佳机票预订API,放到自己接单收款的网站上就是个糟糕的选择。两者对旅行社员工整天使用的内部工具也都不对。搜索、报价、预订在任何文档里看起来都一样,差别藏在它们下面,而哪些差别会伤到你,完全取决于产品。
三种产品,都被叫作“机票预订网站”
第一种是比价或灵感页面:展示票价,链接出去,从不碰机票。这里API几乎只剩搜索。你关心结果有多广、多新,以及展示价与访客到达后看到的价格是否足够接近。你的系统从不需要作废、退款或改签,所以供应商在这方面的强项对你毫无用处。
第二种要销售。访客向你付款,你去订票,从此你就拥有一整套订单生命周期:扣款前确认价格,应对反应迟缓的航司,当天作废,事后退款,客户改日期时改签。对这种产品,搜索接口是最容易的部分。真正决定选择的属性都在它之后。
第三种是旅行社自用工具,使用者是本来就有供应商关系的员工。重点不在原始搜索,而在于旅行社自己谈下来的内容能显示出来,下级代理可以被信用额度约束,加价在任何人看到价格之前就已生效,月底有报表可查。一个对第二种产品表现出色的API,仍可能是这里的错误地基。
不妨直说:同一个API不可能在三种场景里都是最佳。如果某个排名声称可以,说明它没遇到过第二种。
值得比较的属性,以及谁依赖哪一项
把功能表精简到开发者真会有分歧的几行。每种产品只依赖其中一部分,其余的尽可放心忽略。
| 属性 | 跳转导流页面 | 自己销售并收款 | 旅行社员工工具 |
|---|---|---|---|
| 展示的价格在确认前允许过期多久 | 有点影响 | 决定性:你按这个价格扣款 | 重要:员工按此报价 |
| 航司响应缓慢时,订单返回什么 | 不适用 | 决定性 | 重要 |
| 谁能作废和退款,如何发起 | 不适用 | 决定性 | 决定性 |
| 结果未知的订单如何处理 | 不适用 | 决定性:卡可能已经被扣款 | 重要 |
| 是否适用旅行社自有内容与信用规则 | 不适用 | 有时 | 决定性 |
| 测试环境与正式环境的行为有多大差别 | 低 | 高 | 高 |
只看你自己的那一列,别管其他列。真正花钱的错误,是因为跳转导流那一列最容易评估就去读它,结果却做了第二种产品。
你展示的价格,不等于你收取的价格
拿第二种产品,把一张票价从头走到尾。搜索返回一个价格。访客看了看,想了想,开了另一个标签页,又回来。过了一会儿,他点下按钮。从搜索到点击,这个票价一直躺在你的系统里,对任何API唯一诚实的问题是:此刻你再问一次,它会怎么说。
供应商有三种答案。它可以确认你展示的价格。它可以返回新价格,由你的代码决定是补收差价、询问客户还是中止。或者它会说这个票价已经没有了。只为第一种答案做过规划的网站,在每次演示里都正常,随后几周却会出问题,而且是以损失金钱而不是抛出错误的方式。
所以设计问题不是API有没有价格确认这一步,几乎都有。问题是三种结果的响应各是什么样,你的代码能否不靠猜测就区分它们。每种都要一个示例。文档里能给出第二种和第三种的供应商,想过你的产品;只给第一种的,想的是演示。
一个下午的测试,任何对比表都给不了
无论短名单上是谁,对每一个都跑同样一套简短测试,并且故意制造失败。订一张票,出票后看订单对象保留了什么。同一行程间隔几分钟报价两次,看第二次的结果与第一次有何关系。取消,然后申请退款,记下需要谁来操作。最后以书面形式向供应商提两个问题:航司在预订中途超时,你们的系统返回什么?我又如何得知实际发生了什么?
书面答复比演示更有价值。对结果未知有清晰流程的供应商,之前遇到过这个问题;用一个功能名称来回答的,则没有。
至于怎样制定测试计划本身,沙箱测试计划讲了沙箱不会告诉你的那些事。如果你是按API背后的支撑而不是API本身来比较供应商,那是另一个问题,另有专文;本文只谈产品。
只看接口清单选型,你要付出什么
这些失败悄无声息。网站确认价格太晚,展示价与真实价之间的差额一单一单地从你的利润里扣掉。一张订单处于未知状态,客户的卡却已被扣款,必须有人手动处理,通常靠邮件,通常在周末。基于纯搜索内容搭建的工具,最后发现员工无法出票,项目只好围绕另一种内容重做。
这些在打勾的对比表里一个也看不到。但在上面那张表的第一列里,写代码之前就都看得见。
我们自己的立场比排名所能宣称的要窄。Tekravel提供机票和酒店API,接入从一次沟通开始而不是自助密钥,服务按租户开通,供应商内容通过供应商组送达租户。这适合第二种和第三种产品。如果你做的是第一种,也许根本用不着我们。
如果你做的是另外两种之一,可以从API页面开始沟通。