集成目录
Amadeus API集成：机票连接器分步配置
Amadeus模块将PHPTRAVELS的机票搜索连接到Amadeus Enterprise。注册应用，在后台粘贴三项凭证，在开发模式下测试，待Amadeus批准您的账户后切换到生产环境。
- Enterprise套餐连接器
- OAuth2 client credentials
- 开发与生产环境
- 已发布配置指南
连接器配置
五步从Amadeus应用到实时机票结果
该连接器是现成的模块，标准配置无需编写代码。您使用自己的Amadeus账户和商务条款，模块在PHPTRAVELS机票模块内处理认证、机票搜索和订单创建。
- 选择包含Amadeus模块的Enterprise套餐
- 在Amadeus for Developers注册，并创建启用Flight Offers Search和Flight Create Orders的应用
- 在后台“模块”中填写grant type、client ID和client secret，并开启Dev mode
- 在网站上搜索机票，确认“立即预订”按钮下方显示Amadeus标志
- 申请生产密钥，替换沙盒密钥，并将Dev mode切换为生产
- Dev mode
- 开发
- 端点
- travel.api.amadeus.com/v2/
- c1 · grant_type
- client_credentials
- c2 · client_id
- ••••••••••7Kq2
- c3 · client_secret
- ••••••••••
连接器的作用
Amadeus报价进入搜索，订单进入后台
模块由两个Amadeus API驱动：一个将机票报价返回到结果页，另一个在旅客付款时创建预订。
- API伦敦至纽约 · 直飞经济舱 · 8小时05分 · 1件托运行李US$486每位成人
- v2伦敦至纽约 · 经停1次经济舱 · 11小时20分 经都柏林 · 1件托运行李US$412每位成人
- 伦敦至纽约 · 直飞商务舱 · 7小时55分 · 2件托运行李US$2,140每位成人
Flight Offers Search与Flight Create Orders
Offers Search填充搜索结果，Create Orders将所选报价转为预订。在Amadeus应用中同时启用两者，即可搜索和预订。
OAuth2认证
模块使用client_credentials授权方式，凭您在后台填写的client ID和secret请求访问令牌。
开发与生产模式
一个Dev mode设置决定请求使用沙盒密钥还是已获批的生产密钥。
Enterprise端点
模块基于travel.api.amadeus.com/v2/。部分地区使用不同端点，填写密钥前请先确认您的端点。
每条结果显示来源
“立即预订”按钮下方的Amadeus标志表明哪些票价来自Amadeus，一眼即可确认连接是否正常。
常见错误原因
多数故障源于凭证错误、模式与密钥不匹配，或Amadeus控制台中某项API服务未启用。
请求流程
每次Amadeus搜索时发生了什么
开发和生产环境运行相同的流程，只有密钥和Dev mode设置不同。
认证
使用client ID和secret换取访问令牌。
搜索
Flight Offers Search返回该航线、日期和乘客的票价。
展示
报价加上您的加价后显示，并与其他已连接供应商的结果并列。
下单
Flight Create Orders使用旅客信息预订所选报价。
记录
预订保存在后台，确认邮件自动发送。
Amadeus的定位
您的Amadeus账户、其他机票API与定制开发
Amadeus模块是多个机票连接器之一，每个连接器使用各自的凭证，在同一搜索中运行。
您的Amadeus Enterprise账户
Amadeus审核您的使用场景、公司注册信息和网站后签发生产密钥，并由您接受其商务条款。
其他机票连接器
从集成目录添加Duffel、Kiwi或其他机票供应商，在同一结果列表中比较票价。
其他端点与API
地区性Amadeus端点或模块尚未使用的API，可通过定制开发添加。
后台
在同一后台管理Amadeus预订
填好密钥后，Amadeus票价遵循您已为其他机票供应商设置的规则。
机票加价
设置固定或百分比加价，让Amadeus票价显示您的销售价。
预订列表
Amadeus预订及旅客信息和状态显示在机票预订页面中。
B2B代理商
代理商在代理门户中以自己的价格搜索和预订Amadeus票价。
支付
旅客通过您启用的支付网关付款，代理商可从钱包支付。
密钥保存在您的服务器
凭证保存在您自托管的后台中，而不是共享平台上。
支持工单
连接或预订需要帮助时，可在app.phptravels.com提交工单。
对比
自行对接Amadeus与使用PHPTRAVELS模块
两者使用同一个Amadeus账户，区别在于您的团队需要编写和维护多少周边功能。
| 任务 | 直接对接API | PHPTRAVELS |
|---|---|---|
| 认证 | 直接对接API令牌请求和续期由开发人员编写 | PHPTRAVELS模块通过三个后台字段处理 |
| 搜索结果 | 直接对接API报价数据需映射到自建结果页 | PHPTRAVELS报价显示在现有机票搜索中 |
| 预订 | 直接对接API旅客表单和下单调用从零开发 | PHPTRAVELSCreate Orders已接入结账和支付 |
| 测试与上线 | 直接对接API每个环境单独配置 | PHPTRAVELS一个Dev mode开关 |
| 加价与预订 | 直接对接API需要设计并开发后台 | PHPTRAVELS机票后台已包含 |
| 配置步骤 | 直接对接API由团队编写并持续更新 | PHPTRAVELS指南已发布在docs.phptravels.com |
使用场景
谁会启用Amadeus模块
在线旅行社
基于Amadeus内容的公开机票搜索，配合您的加价和结账流程。
B2B代理网络
下级代理商通过您的门户按您的价格预订Amadeus票价。
差旅管理公司
企业预订人在您托管和掌控的平台上搜索Amadeus票价。
为什么选择PHPTRAVELS
可阅读、可修改、可自托管的连接器
包含源代码
基于商业许可自行托管，开发人员可以扩展Amadeus模块。
有文档的配置
每个步骤、字段和错误原因都写在docs.phptravels.com上。
24种语言
以目标市场的语言展示Amadeus票价，包括从右到左的语言。
B2C与B2B
一套安装同时支持公开网站和代理门户。
它是一个现成的机票模块。您在Amadeus for Developers创建应用，在后台填写其凭证，Amadeus报价即会出现在机票搜索中，并通过Flight Create Orders创建预订。
Amadeus模块随Enterprise套餐提供，价格页面列明为一次性付款$9999。您的Amadeus账户及其商务条款需另行与Amadeus商定。
grant type为client_credentials，以及client ID和client secret。创建应用时Amadeus签发沙盒密钥，批准生产申请后签发生产密钥。
模块使用travel.api.amadeus.com/v2/。部分地区的端点或参数不同，请先核对您的账户；其他端点可通过定制开发添加。
两者皆可，取决于Amadeus应用中启用的API。Flight Offers Search提供结果，预订需启用Flight Create Orders。
已有文档的连接器用于机票。Amadeus也列为住宿供应商，但其配置指南尚未发布，酒店范围请咨询我们的团队。