Каталог интеграций
Интеграция Amadeus API: коннектор авиабилетов, настройка по шагам
Модуль Amadeus подключает поиск авиабилетов PHPTRAVELS к Amadeus Enterprise. Зарегистрируйте приложение, вставьте три учётных параметра в админку, протестируйте в режиме разработки и переключитесь на production после одобрения аккаунта в Amadeus.
- Коннектор тарифа Enterprise
- OAuth2 client credentials
- Разработка и production
- Опубликованное руководство
Настройка коннектора
От приложения Amadeus до живой выдачи рейсов за пять шагов
Коннектор — готовый модуль, поэтому для стандартной настройки не нужно писать код. Вы используете свой аккаунт Amadeus и свои коммерческие условия, а модуль берёт на себя аутентификацию, поиск рейсов и создание заказов внутри модуля авиабилетов PHPTRAVELS.
- Начните с тарифа Enterprise, в который входит модуль Amadeus
- Зарегистрируйтесь в Amadeus for Developers и создайте приложение с Flight Offers Search и Flight Create Orders
- Укажите grant type, client ID и client secret в разделе модулей админки, включив Dev mode
- Найдите рейсы на сайте и проверьте логотип Amadeus под кнопкой «Забронировать»
- Запросите production-ключи, замените ими ключи sandbox и переключите Dev mode на production
- Dev mode
- Разработка
- Endpoint
- travel.api.amadeus.com/v2/
- c1 · grant_type
- client_credentials
- c2 · client_id
- ••••••••••7Kq2
- c3 · client_secret
- ••••••••••
Что делает коннектор
Предложения Amadeus в поиске, заказы в админке
Модуль работает на двух API Amadeus: одно возвращает предложения перелётов на страницу результатов, другое создаёт бронирование, когда путешественник оплачивает.
- APIЛондон — Нью-Йорк · Без пересадокЭконом · 8 ч 05 мин · 1 место багажа486 $за взрослого
- v2Лондон — Нью-Йорк · 1 пересадкаЭконом · 11 ч 20 мин через Дублин · 1 место багажа412 $за взрослого
- Лондон — Нью-Йорк · Без пересадокБизнес · 7 ч 55 мин · 2 места багажа2 140 $за взрослого
Flight Offers Search и Flight Create Orders
Offers Search заполняет выдачу, Create Orders превращает выбранное предложение в бронирование. Включите оба API в приложении Amadeus для поиска и бронирования.
Аутентификация OAuth2
Модуль запрашивает токены доступа по схеме client_credentials, используя client ID и secret, указанные в админке.
Режимы разработки и production
Одна настройка Dev mode определяет, какие ключи используют запросы: sandbox или одобренные production-ключи.
Endpoint Enterprise
Модуль построен на travel.api.amadeus.com/v2/. В некоторых регионах endpoint другой, поэтому проверьте свой до ввода ключей.
Источник в каждом результате
Логотип Amadeus под кнопкой «Забронировать» показывает, какие тарифы пришли из Amadeus, и подключение видно сразу.
Известные причины ошибок
Чаще всего это неверные учётные данные, режим, не совпадающий с ключами, или неактивный сервис API в кабинете Amadeus.
Поток запросов
Что происходит при каждом поиске в Amadeus
Последовательность одинакова в разработке и в production; меняются только ключи и настройка Dev mode.
Аутентификация
Client ID и secret обмениваются на токен доступа.
Поиск
Flight Offers Search возвращает тарифы по маршруту, датам и пассажирам.
Показ
Предложения выводятся с вашей наценкой рядом с результатами других подключённых поставщиков.
Заказ
Flight Create Orders бронирует выбранное предложение с данными путешественника.
Запись
Бронирование сохраняется в админке, подтверждение уходит по email.
Место Amadeus
Ваш аккаунт Amadeus, другие API авиабилетов и доработки
Модуль Amadeus — один из нескольких коннекторов авиабилетов, и каждый работает со своими учётными данными в одном поиске.
Ваш аккаунт Amadeus Enterprise
Amadeus выдаёт production-ключи после проверки сценария использования, регистрации компании и сайта, а вы принимаете её коммерческие условия.
Другие коннекторы авиабилетов
Добавьте Duffel, Kiwi или других поставщиков из каталога интеграций и сравнивайте тарифы в одной выдаче.
Другие endpoint и API
Региональный endpoint Amadeus или API, которое модуль пока не использует, можно добавить как индивидуальную разработку.
Поставщики авиабилетов, которых можно подключить:
Seeru
Amadeus
Duffel
Google Flights
Kayak
Kiwi
Mystifly
PKfare
Sabre
TBO Holidays
Travelport
Бэк-офис
Бронирования Amadeus в той же админке
После ввода ключей тарифы Amadeus подчиняются тем же правилам, что и у любого другого поставщика авиабилетов.
Наценки на авиабилеты
Фиксированные или процентные наценки, чтобы тарифы Amadeus показывали вашу цену продажи.
Список бронирований
Бронирования Amadeus с данными путешественников и статусом на экране бронирований авиабилетов.
B2B-агенты
Агенты ищут и бронируют тарифы Amadeus в агентском портале по своим ставкам.
Платежи
Путешественники платят через включённые вами шлюзы, агенты — из кошелька.
Ключи на вашем сервере
Учётные данные хранятся в вашей собственной self-hosted админке, а не на общей платформе.
Тикеты поддержки
Откройте тикет на 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
Коннектор, который можно читать, менять и размещать у себя
Исходный код в комплекте
Self-hosted по коммерческой лицензии, поэтому разработчики могут расширять модуль 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. Ключи sandbox Amadeus выдаёт при создании приложения, production-ключи — после одобрения заявки на production.
Модуль использует travel.api.amadeus.com/v2/. В некоторых регионах другой endpoint или параметры, поэтому сначала проверьте свой аккаунт; другие endpoint можно добавить как индивидуальную разработку.
И то и другое, в зависимости от API, включённых в приложении Amadeus. Flight Offers Search даёт выдачу, а для бронирований должен быть включён Flight Create Orders.
Документированный коннектор предназначен для авиабилетов. Amadeus также указан как поставщик проживания, но руководство по его настройке ещё не опубликовано, поэтому уточните объём по отелям у нашей команды.
Узнайте больше