Amadeus Self Service API 替代方案:用一周完成迁移

通常你是从一次失败的健康检查得知的,或者是从某个用户那里。你的机票应用从第一个原型起就在调用的搜索接口,突然返回一个你从未见过的错误,而你用来管理密钥的门户也已经不在了。如果你正在寻找 Amadeus Self Service API 替代方案,你很可能正处在这样的境地:产品在正常运转,代码是围绕某一家服务商的请求格式写出来的,而在用户发现搜索坏掉之前,你只剩下很短的时间窗口。
关于这家供应商,只有一个事实值得说明,也只说这一个。Amadeus 于 2026 年 7 月 17 日下线了它的 Self-Service API 门户,新的开发者被引导到其企业渠道,而企业渠道是基于合同运作的。本文对此就说这么多。真正有用的问题是:用什么来替代它,以及如何在大约一周内完成迁移,同时不必重建那些仍然正常工作的部分。
自助模式真正给了你什么
人们很容易把旧门户记成“一个机票 API”,然后去找另一个机票 API。但这样会忽略它对一个两人创业团队或一个周末项目真正有价值的地方。主要是三点:
- 一个下午就能用上的测试环境。注册、拿到密钥、调用搜索。没有人问你的公司是做什么的。
- 按量付费。你调用多少就付多少,所以一个只有一百个用户的产品,成本也就是一百个用户该有的成本。
- 没有销售流程。在你开始写代码之前,不需要任何人批准你。
企业合同把这三点全部反了过来。接入要在商务沟通之后才有,价格需要谈判,测试环境要等文书手续办完才到位。从卖方的角度看,这些都不算无理;分销航空公司的运价内容本身就承担着实实在在的义务。但它会改变你的计划。如果你原本打算把一个 API 密钥换成另一个就了事,坦白说,大多数正经的替代方案都已经不是这样运作的了,包括本站提供的方案在内。后文会详细说明。
Amadeus Self Service API 替代方案的三条路线
抛开供应商的名字,替代方案只有三类。它们的差别不在于 JSON 长什么样,而在于你和谁签约,以及最终由谁来出票。
| 路线 | 到第一张真实订单的时间 | 可以期待的内容 | 谁持有出票资质 |
|---|---|---|---|
| 直接签 GDS 合同 | 最长:商务审核、认证,然后才是开发 | 覆盖广泛的 GDS 内容;NDC 和低成本航空取决于你签下的合同 | 如果你持有 IATA 认证,就是你自己;否则你仍然需要一个有资质的伙伴 |
| 聚合商 API | 中等:接入较轻,但要预期签合同 | GDS、NDC 和低成本航空的组合,取决于聚合商接入了哪些来源 | 通常是聚合商,或者它的出票合作方 |
| 批发商(consolidator)的 API | 往往是拿到第一张已出票机票的最短路径,因为出票问题已经解决 | 批发商在卖的一切:它的协议价和净价,以及它的供应商所提供的内容 | 批发商,用它自己的资质出票 |
你可以不同意中间那一列,而且针对你自己的情况,你也应该自己判断。一个已经持有认证、团队里又有商务人员的公司,可能会发现 GDS 路线比表格显示的更快。但大多数在自助沙箱上搭建产品的开发者,从来没有持有过出票资质,而最后一列决定了迁移之后你的产品还剩多少能正常工作。
原因在这里。搜索和报价属于读取操作,三条路线中的任何一条都能提供。出票则是一项财务行为,要在某个主体的资质之下完成,并通过 BSP 或类似机制结算。如果这个主体不是你,你就需要和它签订协议。跳过这个问题的团队,最后会得到一个漂亮的搜索页面,以及一个只会生成预订、却没有人为之付款的“预订”按钮。
内容是另一列需要慢慢读的。GDS 内容和 NDC 内容并不是同一批运价,而低成本航空往往两边都不在。如果你的用户主要在一个低成本航空密集的地区飞短途,那么一条 GDS 覆盖极好的路线,返回的结果也可能很单薄。我们在NDC API 与 GDS:对接入方来说变了什么一文中讲过这个区别。
本平台如何开通,以及为什么它同样不是一把密钥
本平台提供机票和酒店 API。开通是从一次沟通开始的,而不是自助领取密钥。我们直接把这一点说清楚,因为这一周对你来说最糟糕的结果,就是在某个地方注册时以为还是旧的体验,到了第四天才发现中间还卡着一个人工审批。
这次沟通主要围绕表格里的那些问题:你在做什么产品,你的用户是谁,你需要出票还是只需要搜索和报价,以及你面向哪些市场销售。这些答案决定了你能拿到哪些内容,以及订单如何结算。如果你想开始这次沟通,可以从旅游 API 页面开始。
不管你最终选择哪里,在第一封邮件里都问同一个问题:有没有自助的测试密钥?上线生产环境之前需要完成哪些步骤?一个清晰的回答,往往预示着后面的对接也会顺利。一个含糊的回答,同样说明了一些问题。
迁移清单:按照出问题的顺序排列
大多数自助式对接的结构都差不多:搜索、报价、创建订单、出票,然后处理机票生成之后发生的一切。针对新的服务商,把每一步都当作从没写过一样重新测试。请求字段的名字肯定不同,但真正会咬你一口的,是埋在代码里的那些假设。
- 搜索。把你的查询模型(出发地、目的地、日期、乘客、舱位)映射到新的请求格式。检查儿童和婴儿的年龄是怎么传的,多段行程是不是单独的接口,以及空结果长什么样。空列表和报错是两回事,而你的界面很可能把它们当成同一件事处理。
- 报价标识。弄清楚一个报价 id 能保持有效多久,页面刷新之后还能不能用。那种把报价存在会话里、十分钟后再去确认价格的代码,会以新的方式出错。
- 价格确认。在大多数服务商那里,预订前重新确认价格不是可选项。要处理价格已经变化的情况,并决定价格变了之后你的用户会看到什么。
- 订单。乘客姓名、证件字段、联系方式。在发送之前先在你这边校验格式;客户已经付了款、订单却被拒绝,是这份清单上代价最高的错误。
- 出票。确认下单接口是否同时完成出票,还是出票是一个有自己时限的独立步骤。在收任何人的钱之前,先搞清楚机票是以谁的资质开出的。
- 出票后处理。取消、作废(void)、退款、航班变更。这些是原型阶段从来用不到、而真正上线的产品在第一个月就会用到的接口。问清楚它们是在 API 里提供,还是要通过客服处理。
如果需要更完整的测试计划,包括哪些可以模拟、哪些绝对不能模拟,请参阅我们的旅游 API 沙箱测试计划。如果你是从对接的角度切入,机票预订 API 对接一文完整梳理了整个流程。
仓促迁移的代价
最诱人的做法,是把新的服务商包在你原有的客户端接口后面,搜索一返回结果就上线。搜索看起来会一切正常。出问题的,是演示时没有展示的所有东西。
搜索和下单之间价格变了,却以原始报错的形式直接展示给用户,这笔订单就丢了。新的服务商把下单和出票拆成两步,而你的代码没有,于是订单创建了却没有出票,乘客以为自己有票,其实没有。退款流程在有人写信给客服之前一直悄无声息地什么都不做,最后变成一笔拒付。这些问题每一个发生一次都还扛得住。但在整个用户群里反复出现,你就会失去一个小型旅游产品赖以生存的信任。
还有一种更隐蔽的代价。如果你选了一条路线,只因为它这一周最快,结果它并没有你的用户真正在搜的内容,你就得迁移两次。在写任何代码之前,花一天时间把内容和出票的问题想清楚,是整个过程中最便宜的保险。
大致一周的安排
第一天用来回答问题:选哪条路线、要什么内容、用谁的出票资质。第二天和第三天,针对新的服务商做搜索和报价。第四天做下单和出票的端到端流程,包括各种失败情况。第五天处理出票后的流程,并认真读一遍你自己的日志。如果和服务商的沟通超过一天,就同时按照他们的文档开始写代码;请求的结构一旦看过,通常很少再变。
这不会像当初拿到第一把自助密钥那样只花一个下午。也不需要那样。你现在搭建的东西,必须能开出有人为之负责的机票。