供应商与服务API中心

接入同一预订平台的旅游API

本站所有旅游API指南集中于一处:GDS与航空公司内容、酒店床位批发商与外联网、旅游团、租车与接送、支付网关与后台工具。按类别筛选目录,比较获取库存的三种方式,并跟随一项集成从沙盒密钥到正式销售的全过程。

  • 按类别查看集成指南
  • 搜索、定价、预订、出票流程
  • API、预订引擎与GDS对比
  • 自托管并附带源代码

简而言之

什么是旅游API,它们处于什么位置

本中心的每个页面都会出现三个术语。在选择供应商之前,先了解它们各自的含义。

如果您刚接触这个领域,请先阅读什么是 API 集成,再阅读旅游API集成中的技术讲解。完整的现成连接器列表见全部集成,使用这些连接器的预订模块在平台概览中有说明。

  • 旅游API

    一种程序化接口,返回可搜索的旅游数据,例如机票、酒店、租车或旅游团的可用性、运价、规则和内容,通常以JSON或XML形式返回。

  • 旅游API集成

    将供应商、GDS或聚合商的接口接入预订引擎:身份验证、字段映射、幂等的预订调用,以及错误与重试策略。

  • 自托管连接器

    PHPTRAVELS随许可证一并交付连接器代码,您的团队可以阅读、扩展并托管与每个供应商通信的适配器。

所有供应商共用的调用顺序

  1. 01搜索
  2. 02定价与重新验证
  3. 03预订
  4. 04出票或确认

供应商名称和响应格式各不相同,但下方目录中的每个连接器都对应这同一套四步调用。

目录

按类别划分的旅游API

选择一个类别来缩小列表。每个条目都会打开一份专门的指南,介绍该供应商或服务、它返回的内容以及在平台上的设置方法。

GDS、航空公司与机票API

20 篇指南

为机票模块提供内容的全球分销系统、NDC、低成本航空聚合商、票务批发商和航班数据服务。

获取库存的三种方式

旅游API、预订引擎与GDS API对比

团队常把直接API、打包的预订引擎和原始GDS合同当作同一种采购来权衡。它们解决的是不同的问题,通常是组合使用的。

标准旅游API预订引擎GDS API
用途旅游API通过接口获取数据并执行操作预订引擎前端、业务规则与结账GDS API通过传统渠道和NDC获取航空内容与附加服务
内容范围旅游API酒店、机票、租车、活动、床位批发商预订引擎从搜索到结账,覆盖所有已接入内容GDS API主要是航空公司及其附加服务
集成工作量旅游API中等:字段映射、幂等性、重试预订引擎从零构建为中到高;在PHPTRAVELS上为低GDS API高:PCC配置、队列、认证与审计
商务条款旅游API按调用、加价或座位计费,由供应商决定预订引擎PHPTRAVELS一次性许可,外加网关费用GDS APIGDS合同、激励与航段目标
最适合旅游API混合多家供应商的OTA和DMC预订引擎以自有品牌和规则直接销售GDS API以航空为主的代理商和差旅管理公司
上市时间旅游API凭证签发后即可快速上线预订引擎安装、接入供应商、品牌化并上线GDS API最长,因为需要先完成审批和认证

PHPTRAVELS就是预订引擎这一列:供应商API和任何GDS合同都接入其中,因此您只需购买一次软件,再随合同到位逐步添加数据源。价格见价格;托管部分在系统要求中说明。

从密钥到正式销售

API集成如何上线

下方的流程是目录中任何供应商的工作顺序,并附有连接器开启后平台实际交换的请求与响应。

  1. 01

    凭证

    签署供应商协议,获取沙盒密钥、接口地址和文档。

  2. 02

    沙盒连接

    在管理后台输入密钥,执行第一次搜索,确认连接器能够读取响应。

  3. 03

    内容映射

    将供应商代码与平台主数据匹配:机场、酒店ID、餐型、车辆等级。

  4. 04

    加价与规则

    按代理商、B2B代理或客户群设置加价、税费、手续费和货币规则。

  5. 05

    测试预订

    完成供应商的认证场景:预订、修改、取消,并与其测试控制台对账。

  6. 06

    生产密钥

    切换为正式凭证,为公开站点和B2B门户启用该供应商,然后监控首批预订。

平台实际发送的一次重新验证调用

>请求POST /api/v1/hotels/price
{  "supplier": "hotelbeds",1  "env": "production",1  "rateKey": "HB-20261112-118742-DBL-BB",  "occupancy": { "rooms": 1, "adults": 2 },  "currency": "USD",  "markupRule": "b2c-default"2}
<响应200 OK
{  "status": "available",  "net": 184.00,2  "sell": 206.08,2  "currency": "USD",  "cancellation": { "deadline": "2026-11-09", "fee": 184.00 },  "hold": "PT-HLD-7731",3  "expiresIn": 9003}
  1. 1

    供应商密钥按环境存储,绝不会出现在发送给客户的请求体中。

  2. 2

    净价与售价一同传递;加价规则名称告诉后台两者为何不同。

  3. 3

    保留引用让预订调用在客户重试支付时保持幂等。

  4. 查看集成讲解

按业务模式选择

各类旅游企业最先接入哪些旅游API

目录之所以很长,是因为旅游企业各不相同。以下是我们在入驻时常见的起步组合。

  • 01

    在线旅行社

    一个GDS或NDC机票数据源,一到两家酒店床位批发商,一家租车经纪商和一个银行卡网关。先求广度,再谈直签合同。

  • 02

    目的地管理公司

    在后台录入自有库存,用床位批发商补充空缺,接入旅游团平台和接送服务。机票通常稍后通过票务批发商加入。

  • 03

    企业差旅管理

    带协议价的GDS内容,通过外联网或床位批发商建立酒店计划,审批规则和财务导出。

  • 04

    票务批发商或B2B批发商

    多个航空数据源并按分销代理设置加价,代理钱包,银行转账与网关支付,以及财务数据流。

每种模式都有专属页面:在线旅行社、DMC和差旅管理;批发商的分销代理授信部分在代理商钱包中说明。将这些数据源分发给合作伙伴的白标层在白标B2B门户中介绍。

常见问题

旅游API问答

买家在选择供应商之前常问问题的简短回答。

联系销售

旅游API是由供应商、GDS和聚合商提供的接口,开放实时库存、价格、规则以及搜索、重新验证、预订和取消等操作。预订平台调用这些接口,并把响应转化为搜索结果、购物车和已确认的预订。

使用供应商密钥进行身份验证,将其代码映射到您的主数据,按顺序调用搜索、定价和预订,处理错误与重试并避免重复预订,再把结果交给支付、凭证和财务。在PHPTRAVELS上连接器已经实现了这些;您只需处理凭证、映射和规则。

可以。平台为自托管,源代码随商业许可一并提供,您的开发人员可以阅读每个适配器,添加目录中尚未包含的供应商,或修改现有连接器映射内容的方式。

通常是组合而非单一数据源:低成本航空聚合商提供广度,NDC或GDS内容覆盖全服务航空公司与出票,在没有自有航空合同的地方使用票务批发商。目录中的机票分组列出了每种选项的指南。

每个模块可运行多个。平台会查询每个已启用的供应商,按主ID合并结果,去除重复项,并在显示价格前应用您的加价规则,因此添加第二家床位批发商或第二个航空数据源只是配置变更,而非重建。

API本身由各供应商定价,通常按调用、按预订或通过加价协议计费;有些在联盟计划下免费。连接它们的PHPTRAVELS软件为一次性许可,起价2,499美元,详见价格页面。