跳到主要内容
博客

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

Tekravel 编辑部
借助 AI 撰写

周四下午,周一就要演示。你找到了一个免费酒店预订API,用邮箱注册,五分钟拿到密钥。搜索接口返回带照片、星级和每晚价格的酒店,到傍晚结果页已经像模像样。周五你接上预订接口,它回了一个看不懂的错误,因为你注册的这个东西从一开始就没法订任何东西。

没有人骗你。在这个市场里,“免费”被贴在四种不同的产品上,而注册页不会告诉你手里拿的是哪一种。

“免费”的四种含义

这张表值得放在键盘旁边。如果你的供应商做法不同,就反驳其中一行,这本身也是有用的发现。

免费的是什么你得到什么能做什么做不到什么
静态内容或目录数据酒店名称、地址、照片、设施、介绍酒店指南、地图、目的地页面给出你能兑现的价格,或你所选日期真正有空的房间
带跳转的联盟搜索酒店、价格,以及指向卖家结账页的链接把流量送走的比价页把客户、付款或订单记录留在你这边
带测试价格的沙盒完整的搜索、核价、预订、取消调用,返回虚构库存可运行的对接,以及表现得像生产环境的演示生成真实酒店会认可的预订
实时可订价格真实房间,真实的净价或售价,由供应商确认能为房间收款的商店对签合同的人保持免费

前三种之所以免费,是因为送出去几乎不花提供方什么成本。第四种不免费,是因为有人在承担真实的责任。

为什么可订价格总是伴随合同

客户为房间付款时,一串义务随之启动。有一家供应商持有与酒店的合同,它向酒店承诺房费会付,向你承诺房间真实存在。住客在免费取消日期之后取消,就有人欠酒店一晚房费。价格出错,就有人吃下差额。银行卡被盗,就有人为拒付负责。

这一切必须落到一个有名有姓的主体身上。任何人用邮箱就能生成的API密钥承担不了这些,所以可订的接入要配协议、结算安排,通常还有信用额度。“免费”密钥的代价,是提供方不必在意你拿它做什么。

这并不是批评免费套餐。内容数据对目的地指南恰到好处,错只错在把它当成了接受预订所需要的东西。

如果你还在考虑选定的供应商背后需要多少家供应商,我们在需要几家酒店API供应商里讲过;同一种混淆在机票上的版本见免费机票API的三种类型。

第一行里还有一个陷阱。静态内容和实时价格是寿命不同的两路数据:酒店介绍可以在缓存里放几周,今晚的价格连几分钟都放不住。一个顺带显示价格的免费内容接口,报的是它自己不担保的数字,建在它上面的页面会若无其事地展示昨天就已售罄的房间。

签合同之前,在沙盒里测什么

沙盒是表里最有用的免费东西,所以要用足。好的沙盒让你走完真实预订的每一步,库存是假的,但形状和真的一样。

  1. 带儿童、多个房间去搜索。简单的对接最先在入住人数上出问题。请求两个房间、不同的住客,看返回是否把它们分开。
  2. 预订前先核价。许多供应商要求再调一次接口确认价格仍然有效。沙盒里没有这一步,就问问生产环境有没有。
  3. 下单,然后读返回结果。已确认的房间、待处理的请求、需申请的房间是三种不同结果,你的界面必须说清是哪一种。
  4. 在搜索和预订之间改价。价格会变。错误长什么样?你的代码能否给客户显示新价格,而不是一个空白页?
  5. 在免费窗口内外各取消一次。取消政策应以带日期和金额的结构化数据返回,而不是需要你去解析的一段话。
  6. 故意出错。发错误日期、未知酒店代码、过期令牌,数一数返回了多少种不同形状的错误。

如果沙盒做不了第四步和第五步,你拿到的就是一个长得像预订的内容API。

建在错误类型上要付出什么

这个错误真正昂贵的版本,不是丢掉的那一周,而是演示顺利的那一次。

你给决策者看了一个干净的搜索页,他批了预算,团队这才发现背后的数据源无法确认房间。代码不会全废,但预订流程、支付步骤、取消处理和结算都得针对另一家供应商重做,字段名也不同。你演示过的搜索页届时会返回不同的酒店、不同的价格、不同的顺序,批预算的人会发现。

更便宜的习惯,是在写任何代码之前先问一个问题:“这个密钥能创建一个酒店会认可的预订,并在之后取消它吗?”答案不是“能”,你就知道自己手里是四种中的哪一种。

这个平台处在哪个位置

对自己的位置,我们该和对别人一样坦白。平台提供机票和酒店API,接入从一次沟通开始,而不是自助获取密钥。这就是表里的第四行:可订库存背后有人需要知道是谁在提出请求。想看看放到你的项目里是什么样,请从旅行API页面开始,告诉我们你在做什么。

免费内容、联盟链接和沙盒都有各自的位置,哪个合适取决于你打算卖什么。请按客户付款那天密钥能做什么来选。

Tekravel 编辑部

旅游技术组

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