Демоверсия

Интеграция 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 $ с полным исходным кодом, а коннектор RateHawk входит в модуль проживания. Коммерческие условия RateHawk вы согласуете непосредственно с RateHawk.

Да, по адресу api-sandbox.ratehawk.com. Учтите, что тестовыми ключами можно бронировать только тестовый отель с hid 8473727, и это бронирование настоящее, поэтому отмените его сразу после тестирования.

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

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

Да. Один и тот же коннектор обслуживает ваш B2C-сайт и B2B-портал для агентов, с отдельными наценками для каждого канала и группы агентов.

У каждого тарифа есть свои условия отмены, которые показываются до оплаты. Отмены выполняются из админки или личного кабинета клиента через вызов отмены бронирования, в соответствии с этими условиями.

Узнайте больше

Ещё о платформе