在迪拜聘请API集成公司之前,先把这些写进需求

桌上有三份报价。每家集成公司都有一套旅游网站作品集,每家都承诺“把机票API接到你的网站上”,最便宜的那家下周就能开工。你在迪拜德拉区经营一家六个人的旅行社,手上有稳定的企业客户,早就受够了把供应商外联网上的票价一条条抄进WhatsApp消息。挑一家看起来最专业的迪拜API集成公司,似乎就是全部决定。
其实只占三分之一。决定网站能不能卖出去的事情,三份报价里都没有,因为它们不是代码:供应商的合同是跟谁签的,机票以谁的名义出票,从预订到出票之间钱放在哪里,客户取消时由谁办理退款。集成商可以把这些环节连起来,但它替代不了其中任何一个。
这篇文章写给要在工作说明书上签字的老板,而不是要读它的开发人员。
迪拜API集成公司能交付什么,不能交付什么
集成公司写的是供应商API和你的网站之间的代码:搜索表单、查询座位的调用、付款前的验价、预订请求、展示结果的页面,以及在范围写明的情况下,取消和退款的调用。好的集成商还会处理那些枯燥却要紧的部分:供应商超时后的重试,能追查失败订单的日志,一个表现和生产环境一致的测试环境。
它给不了你的,是代码另一侧的一切。在写下第一行代码之前,旅行社需要:
- 一个以旅行社自己名义开设的供应商账户,API权限开在这个账户上;
- 出票资格:要么有自己的资质,要么有一家代为出票的consolidator;
- 和该供应商之间的资金安排:预存款、授信额度,或者直接走信用卡付款;
- 有人负责出票后的工作(作废、退票、改签、航班时刻变更),通过API完成,做不到就手工处理。
主动提出“供应商那边我们来搞定”的集成商,通常是想把它自己的账户借给你。做原型时这可以算一条捷径;对一门生意来说,这意味着你的预订网站建立在一段不属于你、也带不走的关系上。
需求文档:写进工作说明书的七条
和集成商的大多数纠纷,都能追溯到一句当初没人写下来的话。把下面这些用平实的语言写进你要签的文件,并要求每一条都有书面答复。
- 供应商账户和API密钥登记在谁名下。旅行社名下。密钥是凭证,存放在你自己的密码库里,集成商拿到的是访问权限,不是所有权。
- 网站由谁托管,域名由谁持有。域名注册在旅行社名下。托管账户属于旅行社,或者合同写清楚它如何移交。
- 哪些操作在范围之内。逐项写出名称:搜索、报价、预订、出票、取消、退款、变更。不在清单上的,在网站整个生命周期里都只能靠发邮件给供应商的柜台。最常漏掉的是退款和变更,因为演示从来不会展示它们。
- 供应商改API时由谁维护。供应商会下线旧版本、改字段名。没有维护条款的固定价开发,在第一个版本变化的那天就结束了。
- “交付”指什么。源代码放在旅行社自己拥有的代码仓库里,所有凭证,再加一份让其他开发人员能接手的文档。“给你发个压缩包”不叫交付。
- 上线如何验证。在供应商的测试环境里,从搜索一路走到出票,包括一次取消,全部跑通之后,才允许向真实客户收款。
- 客户数据如何处理。旅客姓名、护照信息、支付参考号:存在哪里,谁能查看,怎样删除。
这几条都不需要技术背景就能写。每一条在开发之前谈妥,都比开发之后再谈便宜。
把供应商内容放上网站的三种方式
请集成商对接某家供应商的API,只是其中一条路。在让报价替你做决定之前,值得把它和另外两条放在一起看。
| 方式 | 供应商关系在谁手里 | 谁负责让连接持续可用 | 旅行社还要自己建什么 | 离开的代价 |
|---|---|---|---|---|
| 集成商把你的网站接到某家供应商的API | 如果需求写明,在旅行社手里;否则往往在集成商手里 | 签了维护合同的集成商,或者没人 | 后台、加价、客户档案、报表、支付、售后页面 | 代码和密钥是你的,代价不大;不是你的,就得重做 |
| 集成商把你的网站接到某个平台的API | 平台持有供应商合同;旅行社持有自己在平台上的账户 | 供应商一侧由平台负责,你这一侧由集成商负责 | 你的网站,以及平台API覆盖不到的部分 | 把你这一侧按另一套API重写 |
| 已经接好内容的white-label网店 | 平台,通过旅行社的账户 | 平台 | 内容、定价决策、你自己的客户 | 把域名和客户名单迁到另一家服务商 |
真正值得争论的是第一行。它给你的控制权最大,压在你身上的担子也最重:供应商的每一次变动、每一项新服务、第一版漏掉的每一个操作,都会变成又一个项目、又一份报价。
如何在已有网站上加入搜索,见在现有网站上添加机票搜索;搜索背后选谁的API,见机票预订API供应商背后是什么。本文讲的是围绕这项工作的合同。
这个平台的位置
这个博客背后的平台开放机票和酒店API。接入从一次沟通开始,而不是自助领取密钥,因为最先要回答的就是上面那些问题(开通哪些服务、面向哪个市场、资金如何流转),而不是调用哪个端点。服务按账户开通,每个账户都有自己的管理后台,有各自的订单、客户、加价和报表,所以第二行“还要自己建什么”那一栏,比看上去要短。
如果你这一侧要交给集成公司来做,请在接受报价之前先完成这次沟通,让工作范围描述的是它真正要对接的那套API。从旅游API页面开始。
需求写得马虎,代价是什么
网站上线了。搜索正常,价格看起来也对,第一笔订单在周四晚上进来。它没法以你的名义出票,因为供应商账户属于集成商,按集成商的安排出票。客户的卡已经扣款。现在你手里有一笔订单,既不能出票,也不能通过自己的网站退款。
或者网站顺利跑了一年。然后供应商升级到新版本API,预订停了,而集成商那份固定价合同在交付时就已结束,于是报来一个新项目。你只能付钱,因为看得懂这套代码的,只有报价的人。
又或者集成商只是忙别的客户去了。一位客户要改机票上的名字,变更操作从来不在范围里,你的两名员工一下午都在给供应商柜台写邮件。这恰恰是网站本该替你省掉的活。
每一种情况,都是需求里少写了一句话。而代码,每一次都没有问题。