Интеграция API Amadeus GDS — это процесс подключения вашего приложения или платформы к глобальной системе дистрибуции Amadeus для доступа к актуальным данным о рейсах, ценам, доступности и возможностям бронирования. Amadeus — один из крупнейших поставщиков GDS в мире, обслуживающий авиакомпании, туристические агентства и технологические компании в более чем 190 странах.

При интеграции с Амадей, вы подключаетесь к актуальной базе данных о местах, тарифах, дополнительных услугах и расписаниях авиакомпаний, которая поддерживается в режиме реального времени. Это фундаментально отличается от очистки сайта бронирования или использования статических данных о рейсах.

Вот к чему Amadeus GDS предоставляет вам доступ при создании собственного API:

• Доступность рейсов сотен авиакомпаний по всему миру в режиме реального времени
• Опубликованные тарифы, согласованные тарифы и корпоративные структуры тарифов
• Создание и управление PNR для подтверждения бронирования
• Контент NDC от авиакомпаний, предлагающих прямое распространение
• Вспомогательные услуги, включая выбор места, багажа и предпочтения в питании
• Данные об аэропортах и ​​авиакомпаниях для построения слоев поиска и отображения

Для туристических агентств и компаний, занимающихся туристическими технологиями, этот уровень доступа означает, что вы можете создавать системы, которые ведут себя именно так, как нужно вашему бизнесу, а не так, как решил поставщик.

Создание собственного API бронирования путешествий — правильный выбор не для каждой организации. Для этого требуются ресурсы для разработки, постоянное обслуживание и четкое понимание того, что вам нужно от интеграции. Но для следующих типов бизнеса он приносит прибыль, намного превышающую инвестиции.

Туристические агентства выходят за рамки стандартных инструментов

Если ваше агентство обрабатывает значительные объемы бронирования, а вы ограничены текущей системой бронирования, специальный API дает вам полный контроль над потоком бронирования, логикой ценообразования, правилами наценки и отчетностью. Вы перестаете платить посреднику за транзакцию и начинаете владеть всем рабочим процессом.

Стартапы в сфере туристических технологий, создающие порталы бронирования

Создание стартаповПорталы бронирования авиабилетов B2C илибелые порталы для полетов нужен надежный, масштабируемый источник полетных данных. Интеграция API Amadeus GDS дает вам оперативную основу запасов, необходимую вашему продукту с самого первого дня.

Агрегаторы и консолидаторы

Агрегаторам путешествий, которые обслуживают несколько агентств или потребительскую аудиторию, необходимы возможности поиска в больших объемах и гибкая логика отображения тарифов. Пользовательскийпортал-агрегатор путешествий Созданный на базе Amadeus, вы получаете тот контроль и производительность, которые необходимы вашей платформе.  

Компании по управлению корпоративными поездками

Корпоративным TMC необходимо обеспечить соблюдение политик, логику выбора предпочтительного оператора связи и отчетность, встроенную в рабочий процесс бронирования. Пользовательский API позволяет вам встроить все это в ядро, а не привязывать его к общей платформе.

Шаг 1. Зарегистрируйтесь в Amadeus для доступа для разработчиков

Прежде чем написать одну строку кода, вам необходимо зарегистрироваться для доступа кAmadeus для разработчиков программа. Amadeus предлагает портал для разработчиков самообслуживания с тестовой средой, которая дает вам бесплатный доступ к смоделированным полетным данным, чтобы вы могли построить и протестировать свою интеграцию перед ее запуском в эксплуатацию.

Вот что нужно сделать:

• Перейдите на портал Amadeus для разработчиков и создайте бесплатную учетную запись
• Создайте новое приложение на портале, чтобы сгенерировать ключ и секрет API
• Просмотрите доступные API и определите, какие из них вам нужны для вашего варианта использования.
• Ознакомьтесь с ограничениями тестовой среды, включая смоделированные данные PNR

Как только ваша заявка будет одобрена, вы получите ключ API и секрет API, которые ваш сервер будет использовать для аутентификации на платформе Amadeus.

Шаг 2. Выберите свой технологический стек

Пользовательский API бронирования путешествий разработка хорошо работает с несколькими серверными стеками. Amadeus предоставляет официальные SDK для Node.js и Python, которые значительно упрощают интеграцию. Вот справочная информация о наиболее часто используемых технологиях:

Для большинства команд, создающих API для бронирования среднего и крупного масштаба, Node.js с Express в сочетании с кэшированием Redis и PostgreSQL для записей бронирования является надежным и масштабируемым выбором.

Шаг 3. Аутентификация с помощью API Amadeus с использованием OAuth 2.0

Amadeus использует OAuth 2.0 для аутентификации. Прежде чем вы сможете позвонить в любую конечную точку поиска рейсов или бронирования, вашему серверу необходимо запросить токен доступа, используя ваш ключ и секрет API. Этот токен затем передается как токен носителя во всех последующих запросах API.

Токен имеет ограниченный срок действия, обычно около 30 минут, поэтому вашему приложению необходимо автоматически обрабатывать обновление токена. Встройте в свой API уровень управления токенами, который проверяет срок действия перед каждым исходящим запросом и обновляет токен при необходимости.

Шаг 4. Внедрение основных конечных точек API Amadeus

Amadeus API для турагентов предоставляет широкий спектр конечных точек. Для функционального API бронирования путешествий вам необходимо реализовать эти основные конечные точки в определенном порядке, который отражает процесс бронирования:

Каждая конечная точка влияет на следующую. Путешественник ищет авиабилеты, выбирает маршрут, подтверждает цену и затем бронирует. Ваш API должен надежно обрабатывать всю последовательность действий, включая крайние случаи, такие как истечение срока действия тарифа и распроданный инвентарь.

Шаг 5. Создайте слой поиска рейсов

Уровень поиска рейсов — наиболее критичная к производительности часть вашего API. Каждый поисковый запрос попадает в Amadeus в режиме реального времени и возвращает потенциально большой объем ответа. Вот как его правильно построить:

• Принять пункт отправления, пункт назначения, дату путешествия, количество пассажиров и класс салона в качестве входных параметров
• Проверяйте входные данные перед отправкой в ​​Amadeus, чтобы избежать ненужных вызовов API и использования квот
• Реализуйте кэширование для повторяющихся идентичных поисков в течение короткого промежутка времени с помощью Redis
• Проанализируйте ответ Amadeus, чтобы извлечь и отформатировать соответствующие данные предложения для вашего интерфейса
• Включите обработку ошибок при отсутствии результатов, тайм-аутах API и сбоях в работе служб Amadeus
• Регистрируйте все поисковые запросы с отметками времени и параметрами для отладки и аналитики

Создание системы бронирования путешествий, лучшие практики также включают реализацию обработки ограничений скорости. Amadeus имеет ограничения на количество запросов в минуту в зависимости от вашего уровня API, поэтому вашему уровню поиска необходимо ставить запросы в очередь или регулировать их при достижении этих ограничений.

Шаг 6. Создайте уровень управления бронированием и PNR

Создание бронирования через Amadeus API включает два этапа. Сначала вы меняете цену выбранного предложения, чтобы подтвердить текущую доступность и тариф. Во-вторых, вы отправляете бронирование с данными о пассажирах для создания PNR. Вот поток:

1. Позвоните по цене предложений рейсов с выбранным идентификатором предложения, чтобы получить подтвержденную текущую цену
2. Предъявите путешественнику подтвержденную цену для принятия
3. Соберите информацию о путешественнике, включая полное имя, дату рождения, номер паспорта или удостоверения личности, а также контактную информацию
4. Отправьте запрос на создание заказов на авиабилеты с ценовым предложением и данными путешественника
5. Сохраните возвращенный PNR и номер бронирования в своей базе данных
6. Вызывать уведомления о подтверждении для путешественника и агента

Вы должны обработать случай, когда ценообразование прошло успешно, но бронирование не удалось из-за условий конкуренции за количество мест. Ваш API должен отображать четкую, удобную для пользователя ошибку и возвращать путешественника к результатам поиска, а не оставлять его на экране неудачного бронирования.

Шаг 7. Реализуйте обработку ошибок и логику повторных попыток

API-интерфейсы для путешествий работают с реальными данными, которые меняются ежесекундно. Места продаются, срок действия тарифов истекает, а время ответа API иногда истекает. API бронирования производственного уровня должен корректно справляться со всем этим. Встройте в уровень обработки ошибок следующее:

• Отличайте исправимые ошибки, такие как тайм-ауты и ограничения скорости, от ошибок терминала, таких как распроданные билеты и срок действия тарифа
• Внедрить логику повторных попыток экспоненциальной отсрочки для временных сбоев
• Возвращайте стандартизированные ответы об ошибках в свой интерфейс, которые преобразуются в удобные для пользователя сообщения
• Предупреждайте свою эксплуатационную группу о повторяющихся сбоях или повышенном уровне ошибок
• Регистрируйте все ответы об ошибках от Amadeus с полной нагрузкой запроса для отладки

Шаг 8. Настройте шлюз API и уровень безопасности

Интеграция GDS для туристических агентств на производственном уровне требуется соответствующая безопасность API, прежде чем вы станете публично раскрывать какие-либо конечные точки. Ваш шлюз API должен обеспечить следующее:

• Аутентификация по ключу API для всех потребительских приложений, вызывающих ваш API
• Ограничение ставок для каждого потребителя во избежание злоупотреблений и защиты вашей квоты Amadeus
• Очистка ввода и проверка запросов на уровне шлюза
• Связь только по протоколу HTTPS с действительными сертификатами SSL
• Белый список IP-адресов для внутренних служб, которые не должны быть общедоступными
• Ведение журнала аудита всех транзакций бронирования на предмет соблюдения требований и разрешения споров

Шаг 9. Создайте набор для тестирования перед запуском в эксплуатацию

Amadeus предоставляет комплексную среду тестирования с смоделированными данными. Используйте эту среду для создания и запуска полного набора тестов перед переключением на рабочие учетные данные. Ваши тесты должны охватывать:

• Поиск возвращает результаты для действительных маршрутов и дат
• Поиск возвращает соответствующее пустое состояние для недоступных маршрутов
• Цена, подтверждающая действительное выбранное предложение
• При бронировании создается действующее бронирование с правильными данными о пассажирах
• Поддерживается обработка отмены
• Состояния ошибок включают предложения с истекшим сроком действия, неверные данные о пассажирах и имитацию тайм-аута

Не пропускайте этот шаг. Проблемы, возникающие в процессе эксплуатации при активном бронировании, обходятся гораздо дороже, чем проблемы, обнаруженные во время тестирования с использованием смоделированных данных.

Шаг 10. Публикация и версия вашего API

После завершения тестирования и готовности вашего API к производству последним шагом станет его публикация для использования вашими потребителями. Независимо от того, является ли ваш API внутренним, используемым только вашим собственным порталом, или внешним, предлагаемым другим агентствам или разработчикам, управление версиями с самого начала избавит вас от значительных проблем в дальнейшем.

• Используйте семантическое управление версиями в структуре URL-адресов API, например v1 и v2, с самого начала
• Публикуйте документацию по API с помощью таких инструментов, как Swagger или Postman, чтобы потребители могли самостоятельно обслуживать
• Настройте журнал изменений, чтобы потребители знали, какие изменения происходят между версиями
• Поддерживать обратную совместимость в основной версии.
• Прежде чем объявлять устаревшей какую-либо конечную точку, предоставьте потребителям соответствующее уведомление

Поиск рейсов по своей сути является дорогостоящим с точки зрения вызовов API. Каждый поиск попадает в Amadeus в режиме реального времени, и в масштабе совокупная стоимость использования API и задержка ответа могут стать серьезной операционной проблемой. Хорошо спроектированный уровень кэширования решает обе проблемы.

Ключевой принцип заключается в том, что данные о доступности рейсов относительно стабильны в течение короткого временного интервала. Поиск рейсов из Лондона в Дубай на определенную дату вряд ли выдаст совершенно другие результаты через 60 секунд. Кэшируя идентичные результаты поиска на срок от 60 до 120 секунд, вы можете мгновенно обслуживать повторяющиеся запросы, не сжигая дополнительную квоту API Amadeus.

Используйте Redis в качестве уровня кэширования. Создайте согласованный ключ кэша на основе параметров поиска, включая пункт отправления, пункт назначения, дату, пассажиров и салон, а затем сохраните полный ответ Amadeus на этот ключ с TTL, соответствующим вашему варианту использования. Для ценообразования и бронирования никогда не кэшируйте. Всегда извлекайте актуальные данные на этих этапах.

Пропуск тестовой среды

Переход сразу к производственным учетным данным без тщательного тестирования в среде «песочницы» приводит к ошибкам при бронировании с реальными деньгами путешественника. Всегда завершайте свой набор тестов в тестовой среде Amadeus, прежде чем запрашивать доступ к рабочей среде.

Не обработка истечения срока действия токена

Срок действия токенов OAuth истекает. Если ваше приложение не обрабатывает обновление токена автоматически, ваш API начнет возвращать ошибки аутентификации в середине сеанса. Встраивайте управление токенами в основу своей интеграции, а не как второстепенную мысль.

Игнорирование правил и условий тарифа

Amadeus возвращает правила и условия тарифов для каждого предложения. Ваш API должен предоставлять их конечному пользователю перед бронированием. Бронирование без указания условий возврата и изменения является серьезным источником споров и возвратных платежей после бронирования.

Построение без осведомленности об ограничении скорости

Amadeus налагает ограничения на скорость для всех уровней API. Создание слоя поиска, который отправляет неограниченное количество запросов к Amadeus без какого-либо регулирования, приведет к возникновению ошибок 429 и снижению производительности для всех пользователей. Создайте обработку ограничения скорости с самого начала.

Учетные данные жесткого кодирования

Никогда не кодируйте ключ и секрет API Amadeus жестко в коде приложения и не используйте их для контроля версий. Используйте переменные среды и менеджер секретов для обеспечения безопасности учетных данных.

Создание API-интерфейса бронирования путешествий промышленного уровня с интеграцией Amadeus GDS требует глубоких знаний как в платформе Amadeus, так и в рабочих процессах туристической индустрии. В Конечная остановка полетаМы предоставили индивидуальные решения в области туристических технологий для туристических агентств, агрегаторов и компаний, занимающихся туристическими технологиями, на различных рынках.

Вот что мы предлагаем по всему спектру наших решений:

• Портал бронирования авиабилетов B2C: Порталы поиска и бронирования авиабилетов, ориентированные на потребителя, построенные на основе актуальных данных GDS с полной интеграцией платежей. Посмотреть портал B2C
• B2B-решение для бронирования авиабилетов: Платформы бронирования для агентов со встроенными функциями управления наценками, кредитным контролем и видимостью PNR.Посмотреть решение B2B
• Портал туристического агрегатора: Платформы-агрегаторы большого объема, которые обслуживают несколько агентств или потребительских сегментов из одного бэкэнда. Посмотреть портал агрегатора
• Портал полетов White Label: Полностью фирменные решения «white label», которые агентства могут использовать под своим собственным брендом. Посмотреть портал White Label
• Интеграция Amadeus GDS: Полная интеграция с Amadeus GDS, включая поиск предложений рейсов, создание заказов на рейсы, карту мест и вспомогательное оборудование. Посмотреть интеграцию с Amadeus
• Решение AQC Flight API: уровень консолидированного доступа к нескольким источникам данных. Посмотреть решение AQC
• Интеграционные услуги: Комплексные услуги по интеграции туристических технологий для подключения существующих систем к новым источникам данных и платформам бронирования. Просмотреть службы интеграции