免费酒店预订API:免费到底给了你什么

周四下午,周一就要演示。你找到了一个免费酒店预订API,用邮箱注册,五分钟拿到密钥。搜索接口返回带照片、星级和每晚价格的酒店,到傍晚结果页已经像模像样。周五你接上预订接口,它回了一个看不懂的错误,因为你注册的这个东西从一开始就没法订任何东西。
没有人骗你。在这个市场里,“免费”被贴在四种不同的产品上,而注册页不会告诉你手里拿的是哪一种。
“免费”的四种含义
这张表值得放在键盘旁边。如果你的供应商做法不同,就反驳其中一行,这本身也是有用的发现。
| 免费的是什么 | 你得到什么 | 能做什么 | 做不到什么 |
|---|---|---|---|
| 静态内容或目录数据 | 酒店名称、地址、照片、设施、介绍 | 酒店指南、地图、目的地页面 | 给出你能兑现的价格,或你所选日期真正有空的房间 |
| 带跳转的联盟搜索 | 酒店、价格,以及指向卖家结账页的链接 | 把流量送走的比价页 | 把客户、付款或订单记录留在你这边 |
| 带测试价格的沙盒 | 完整的搜索、核价、预订、取消调用,返回虚构库存 | 可运行的对接,以及表现得像生产环境的演示 | 生成真实酒店会认可的预订 |
| 实时可订价格 | 真实房间,真实的净价或售价,由供应商确认 | 能为房间收款的商店 | 对签合同的人保持免费 |
前三种之所以免费,是因为送出去几乎不花提供方什么成本。第四种不免费,是因为有人在承担真实的责任。
为什么可订价格总是伴随合同
客户为房间付款时,一串义务随之启动。有一家供应商持有与酒店的合同,它向酒店承诺房费会付,向你承诺房间真实存在。住客在免费取消日期之后取消,就有人欠酒店一晚房费。价格出错,就有人吃下差额。银行卡被盗,就有人为拒付负责。
这一切必须落到一个有名有姓的主体身上。任何人用邮箱就能生成的API密钥承担不了这些,所以可订的接入要配协议、结算安排,通常还有信用额度。“免费”密钥的代价,是提供方不必在意你拿它做什么。
这并不是批评免费套餐。内容数据对目的地指南恰到好处,错只错在把它当成了接受预订所需要的东西。
如果你还在考虑选定的供应商背后需要多少家供应商,我们在需要几家酒店API供应商里讲过;同一种混淆在机票上的版本见免费机票API的三种类型。
第一行里还有一个陷阱。静态内容和实时价格是寿命不同的两路数据:酒店介绍可以在缓存里放几周,今晚的价格连几分钟都放不住。一个顺带显示价格的免费内容接口,报的是它自己不担保的数字,建在它上面的页面会若无其事地展示昨天就已售罄的房间。
签合同之前,在沙盒里测什么
沙盒是表里最有用的免费东西,所以要用足。好的沙盒让你走完真实预订的每一步,库存是假的,但形状和真的一样。
- 带儿童、多个房间去搜索。简单的对接最先在入住人数上出问题。请求两个房间、不同的住客,看返回是否把它们分开。
- 预订前先核价。许多供应商要求再调一次接口确认价格仍然有效。沙盒里没有这一步,就问问生产环境有没有。
- 下单,然后读返回结果。已确认的房间、待处理的请求、需申请的房间是三种不同结果,你的界面必须说清是哪一种。
- 在搜索和预订之间改价。价格会变。错误长什么样?你的代码能否给客户显示新价格,而不是一个空白页?
- 在免费窗口内外各取消一次。取消政策应以带日期和金额的结构化数据返回,而不是需要你去解析的一段话。
- 故意出错。发错误日期、未知酒店代码、过期令牌,数一数返回了多少种不同形状的错误。
如果沙盒做不了第四步和第五步,你拿到的就是一个长得像预订的内容API。
建在错误类型上要付出什么
这个错误真正昂贵的版本,不是丢掉的那一周,而是演示顺利的那一次。
你给决策者看了一个干净的搜索页,他批了预算,团队这才发现背后的数据源无法确认房间。代码不会全废,但预订流程、支付步骤、取消处理和结算都得针对另一家供应商重做,字段名也不同。你演示过的搜索页届时会返回不同的酒店、不同的价格、不同的顺序,批预算的人会发现。
更便宜的习惯,是在写任何代码之前先问一个问题:“这个密钥能创建一个酒店会认可的预订,并在之后取消它吗?”答案不是“能”,你就知道自己手里是四种中的哪一种。
这个平台处在哪个位置
对自己的位置,我们该和对别人一样坦白。平台提供机票和酒店API,接入从一次沟通开始,而不是自助获取密钥。这就是表里的第四行:可订库存背后有人需要知道是谁在提出请求。想看看放到你的项目里是什么样,请从旅行API页面开始,告诉我们你在做什么。
免费内容、联盟链接和沙盒都有各自的位置,哪个合适取决于你打算卖什么。请按客户付款那天密钥能做什么来选。