Демоверсія

Інтеграція API готелів

Інтеграція API RateHawk: від API-ключа до реальних бронювань готелів

Підключіть свій акаунт RateHawk до PHPTRAVELS і продавайте готелі та апартаменти RateHawk на власному сайті й в агентському порталі. Конектор уже готовий: додайте API-ключі, імпортуйте базу готелів, задайте націнку та пройдіть сертифікацію RateHawk.

  • Готовий конектор RateHawk
  • ETG API v3
  • Імпорт дампу готелів
  • Ваша націнка на нетто-тарифи

Постачальник

Що таке RateHawk і навіщо агентства його підключають

RateHawk — B2B-платформа бронювання Emerging Travel Group (ETG) для турагентів, туроператорів і туристичних компаній. Партнери бронюють готелі, апартаменти та інші варіанти розміщення за нетто-тарифами — у власному порталі RateHawk або через його API.

Цей API називається ETG API. Поточна версія — v3: REST API із запитами та відповідями у форматі JSON, що охоплює пошук, бронювання та скасування. У модулі проживання PHPTRAVELS є готовий конектор RateHawk, тож результати RateHawk відображаються поруч із вашими іншими постачальниками готелів і власними контрактами.

За темою:ГотеліМодуль бронювання готелюTravel API

Картка постачальника
Компанія
RateHawk, входить до Emerging Travel Group
Тип
B2B-платформа розміщення для професіоналів туріндустрії
Інвентар
Понад 2,6 млн варіантів розміщення, за даними RateHawk
API-партнери
Понад 700 API-клієнтів, за даними RateHawk за 2024 рік
API
ETG API v3 · REST · JSON
У PHPTRAVELS
Готовий конектор у модулі проживання

Процес бронювання в ETG API v3

Як відбувається бронювання RateHawk, етап за етапом

Кожне бронювання RateHawk проходить ті самі п'ять етапів. Для кожного вказано виклики ETG API і те, що PHPTRAVELS робить за вас.

  1. 01

    Пошук

    Виклики ETG API

    Пошук за регіоном · за геокоординатами · за ID готелів

    PHPTRAVELS

    Шукає за містом, ділянкою на мапі або списком готелів з урахуванням дат, гостей і резидентства мандрівника та показує актуальні нетто-тарифи з вашою націнкою.

  2. 02

    Сторінка готелю

    Виклики ETG API

    Retrieve hotelpage

    PHPTRAVELS

    Завантажує всі номери й тарифи обраного готелю: тип харчування, податки, умови скасування та спосіб оплати.

  3. 03

    Попереднє бронювання

    Виклики ETG API

    Prebook rate · Retrieve rate info

    PHPTRAVELS

    Безпосередньо перед оплатою перевіряє, що обраний тариф досі доступний за цією ціною, і зупиняє оформлення, якщо вона змінилася.

  4. 04

    Бронювання

    Виклики ETG API

    Створення, запуск і перевірка процесу бронювання

    PHPTRAVELS

    Створює бронювання, передає дані гостей, відстежує статус до підтвердження та зберігає ID замовлення RateHawk.

  5. 05

    Після бронювання

    Виклики ETG API

    Retrieve bookings · Cancel booking · Вебхуки статусів

    PHPTRAVELS

    Надсилає ваучер, показує бронювання в адмінці та в особистому кабінеті клієнта й виконує скасування за умовами тарифу.

Статичні дані

Імпортуйте базу готелів RateHawk один раз і підтримуйте її актуальною

Результати пошуку містять лише тарифи. Назви, адреси, фото, зручності й описи беруться зі статичних даних ETG, які PHPTRAVELS імпортує у ваші сторінки готелів.

  • Дамп регіонів

    Країни, міста й райони, щоб мандрівники могли шукати за напрямком.

  • Дамп готелів

    Повний файл контенту готелів: назви, адреси, координати, фото, зручності й описи.

  • Інкрементальний дамп

    Лише зміни з моменту останнього імпорту, щоб каталог залишався актуальним без повного перезавантаження.

  • Дамп відгуків

    Оцінки й тексти відгуків гостей для сторінок готелів, якщо їх передбачено вашим договором.

Імпорт контенту готелів
  • Дамп регіонів100%
  • Дамп готелів100%
  • Інкрементальний дамп64%
  • Дамп відгуків30%

Приклад екрана. Кількість залежить від вашого акаунта та мов.

Окрім файлів дампів, ETG пропонує Content API для отримання даних про готелі на запит.

API-ключ і пісочниця

Як працює автентифікація в API RateHawk

ETG API використовує автентифікацію HTTP Basic. Ваш key ID слугує іменем користувача, а API-ключ — паролем; вони передаються через HTTPS з кожним запитом.

Пошуковий запит у пісочниці (приклад)
 1# HTTP Basic: key ID = username, API key = password 2curl -u "$KEY_ID:$API_KEY" \ 3  -H "Content-Type: application/json" \ 4  https://api-sandbox.ratehawk.com/api/b2b/v3/search/serp/hotels/ \ 5  -d '{ 6    "checkin": "2026-11-14", 7    "checkout": "2026-11-16", 8    "residency": "gb", 9    "language": "en",10    "currency": "USD",11    "guests": [{ "adults": 2, "children": [] }],12    "hids": [8473727]13  }'1415# 8473727 = the test hotel: a real booking if you book it
HTTP BasicETG API v3api-sandbox.ratehawk.com → api.ratehawk.com
Два хости
Пісочниця: api-sandbox.ratehawk.com. Тестове та робоче середовище: api.ratehawk.com. Старі хости worldota.net застаріли.
Тестовий готель — справжній
Тестовими ключами можна бронювати лише тестовий готель із hid 8473727, і це бронювання справжнє, з реальною фінансовою відповідальністю. Скасуйте його одразу після тесту.
Ключі зберігаються на сервері
PHPTRAVELS зберігає key ID і API-ключ у конфігурації сервера, а не в браузері чи застосунку.
Резидентство має значення
Тарифи залежать від резидентства мандрівника, тому конектор передає його в кожному пошуку.

Налаштування в PHPTRAVELS

Налаштуйте конектор RateHawk за чотири кроки

Писати код не потрібно: конектор налаштовується в панелі адміністратора.

  1. 01Додайте API-ключіВставте key ID і API-ключ від RateHawk — спершу для пісочниці, згодом для робочого середовища.
  2. 02Імпортуйте базу готелівЗавантажте дампи регіонів і готелів, потім налаштуйте розклад інкрементальних оновлень.
  3. 03Задайте націнку та валютуВідсоткові або фіксовані націнки за каналом, групою агентів чи напрямком, у валютах, у яких ви продаєте.
  4. 04Протестуйте й запустітьсяВиконайте тестове бронювання та скасування, пройдіть сертифікацію, потім перейдіть на робочі ключі.
Постачальники › RateHawkRateHawk

Середовище

https://api-sandbox.ratehawk.comhttps://api.ratehawk.com

Key ID4127
API-ключ••••••••••••••••
Націнка12% на нетто-тарифи
ВалютаUSD · EUR · GBP
Резидентство за замовчуваннямGB

Приклад екрана налаштувань.

Сертифікація

Від договору до доступу до робочого середовища

RateHawk відкриває робоче середовище лише після підписання договору та проходження вашою інтеграцією сертифікації.

  1. 1

    Підпишіть API-договір

    Ви

    Зв'яжіться з RateHawk як туристична компанія та підпишіть API-договір для своїх ринків.

  2. 2

    Отримайте ключі пісочниці

    RateHawk

    RateHawk видає key ID і API-ключ для пісочниці.

  3. 3

    Підключення та імпорт

    PHPTRAVELS

    Ключі вносяться в PHPTRAVELS, статичні дані імпортуються, націнки налаштовуються.

  4. 4

    Пройдіть сертифікацію

    RateHawk

    RateHawk перевіряє інтеграцію, зокрема процеси бронювання, перевірки статусу та скасування.

  5. 5

    Доступ до робочого середовища

    Ви

    Робочі ключі вносяться в адмінку, і починаються реальні бронювання.

Портал, API чи система бронювання

Три способи продавати готелі RateHawk

Агенти вже сьогодні можуть бронювати на власному сайті RateHawk. А API всередині вашої системи бронювання дає змогу продавати готелі RateHawk під вашим брендом.

  • Сайт RateHawk

    Хто бронює
    Ваші агенти, по одному бронюванню
    Чий бренд
    RateHawk
    Що потрібно
    Зареєструватися як агент і увійти

  • Власна розробка на API

    Хто бронює
    Ваші клієнти й агенти, онлайн
    Чий бренд
    Ваш
    Що потрібно
    Місяці розробки та сертифікації

  • PHPTRAVELS з RateHawk

    Хто бронює
    Ваші клієнти й агенти, онлайн
    Чий бренд
    Ваш
    Що потрібно
    Налаштування, імпорт контенту та сертифікація

Кілька постачальників

RateHawk поруч із вашими іншими постачальниками готелів

RateHawk — один із постачальників у модулі проживання. Той самий пошук може охоплювати ваші інші API готелів і власні контракти, з націнками та маршрутизацією для кожного постачальника.

  • Agoda
  • Amadeus
  • Booking.com
  • Hotelbeds
  • Hotelston
  • RateHawk
  • Stuba
  • TBO Holidays
  • Travelport
  • Wanderbeds
Переглянути ціниВідкрити демо готелів

Читати посібник для агентів

FAQ

Запитання про інтеграцію API RateHawk

Що запитують агентства перед підключенням RateHawk.

Відділ продажів

RateHawk не публікує плату за доступ до API. Ви підписуєте API-договір і продаєте його готелі за нетто-тарифами зі своєю націнкою. Ваші витрати — це програмне забезпечення для бронювання, хостинг і платежі.

Зв'яжіться з RateHawk як туристична компанія та підпишіть API-договір. Потім RateHawk видає key ID і API-ключ для пісочниці, а після сертифікації — робочі ключі.

Документація ETG API доступна онлайн на docs.emergingtravel.com: B2B API, Content API, пісочниця та посібники із сертифікації. Окремого PDF для завантаження немає; актуальною версією є онлайн-документація.

ETG API — це API компанії Emerging Travel Group, якій належить RateHawk. Інтеграція API RateHawk та інтеграція ETG API — одне й те саме; поточна версія — v3.

PHPTRAVELS — це разова ліцензія від 2 499 USD з повним вихідним кодом, а конектор RateHawk входить до модуля проживання. Комерційні умови RateHawk ви погоджуєте безпосередньо з RateHawk.

Так, за адресою api-sandbox.ratehawk.com. Зверніть увагу, що тестовими ключами можна бронювати лише тестовий готель із hid 8473727, і це бронювання справжнє, тому скасуйте його одразу після тестування.

Агенти реєструються та входять на ratehawk.com, щоб бронювати в порталі. Доступ до API — окремий: він використовує key ID і API-ключ із вашого договору, а не логін порталу.

Конектор уже існує, тож час іде не на розробку, а на договір, додавання ключів, імпорт контенту готелів і сертифікацію RateHawk.

Так. Той самий конектор обслуговує ваш B2C-сайт і B2B-портал для агентів, з окремими націнками для кожного каналу та групи агентів.

Кожен тариф має власні умови скасування, які показуються до оплати. Скасування виконуються з адмінки або особистого кабінету клієнта через виклик скасування бронювання, відповідно до цих умов.

Дізнайтеся більше

Ще про платформу