Каталог інтеграцій
Інтеграція 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 USDза дорослого
- v2Лондон — Нью-Йорк · 1 пересадкаЕконом · 11 год 20 хв через Дублін · 1 місце багажу412 USDза дорослого
- Лондон — Нью-Йорк · Без пересадокБізнес · 7 год 55 хв · 2 місця багажу2 140 USDза дорослого
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
Що запитують команди під час налаштування модуля Amadeus.
Відділ продажівЦе готовий модуль авіаквитків. Ви створюєте застосунок в 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 також указано як постачальника проживання, але посібник із його налаштування ще не опубліковано, тож уточніть обсяг щодо готелів у нашої команди.
Дізнайтеся більше