Островок — ETG API (RateHawk): Загрузить описание и фото отеля

Сценарий из mcp-everything. Актуально на 2026-10-24.

Карточка отеля для своей витрины: описание, адрес, удобства и фотографии.

Запроси контент: POST /api/b2b/v3/hotel/info/ с hid и language.
Лимит — не больше 30 запросов за 60 секунд, поэтому кэшируй карточки у себя, а не запрашивай их при каждом показе.
Передавай собственный User-Agent с названием своего приложения — без него запросы могут отклоняться.
Для полной базы отелей используй дампы статического контента, а hotel/info — для точечного обновления.

curl --user '<KEY_ID>:<API_KEY>' 'https://api.ratehawk.com/api/b2b/v3/hotel/info/' \
  -H 'Content-Type: application/json' -H 'User-Agent: MyTravelApp/1.0' \
  -d '{"hid": 8473727, "language": "ru"}'

Базовые URL

Боевой и тестовый: https://api.ratehawk.com
Песочница: https://api-sandbox.ratehawk.com
Старые хосты и устарели.: api.worldota.net

Авторизация

Тип: Basic Auth

HTTP Basic Authentication ключом API вида <KEY_ID>:<API_KEY>: KEY_ID — имя пользователя, API_KEY — пароль. Ключи бывают трёх типов: sandbox, test (только тестовый отель hid = 8473727, брони реальные) и production. Ключи видны в разделе API настроек договора (доступ — у Master-аккаунта).

curl --user '<KEY_ID>:<KEY>' --data '{"id":"city_hotel_berlin_east","language":"en"}' "https://api.ratehawk.com/api/b2b/v3/hotel/info/"

Методы сценария

POST /api/b2b/v3/hotel/info/ — Контент отеля

Не больше 30 запросов за 60 секунд; передавайте собственный User-Agent, например RatehawkPartner/1.0 (python-requests/2.18.4).

Параметр	Где	Тип	Обяз.	Описание
`hid`	body	integer	нет	Числовой ID отеля (нужен он или устаревший id)
`id`	body	string	нет	Устаревший строковый ID отеля
`language`	body	string	нет	Язык

Нюансы

GET — для получения данных (параметры в data строки запроса), POST — для создания, изменения и удаления; тело — JSON-объект.
Рекомендуемый поток: поиск → search/hp → hotel/prebook → booking/form → booking/finish → booking/finish/status (или вебхук).
partner_order_id уникален в рамках договора и используется во всех вызовах после создания брони.
Брони тестового отеля hid = 8473727 реальные — их нужно отменять.
В песочнице язык всегда en, валюта обычно USD/EUR, число тарифов ограничено 5, 3D Secure не поддерживается.
Лимиты и доступные эндпоинты ключа — метод Retrieve endpoints; лимиты повышают только после сертификации.

Другие сценарии

Если этого недостаточно — официальная документация: https://docs.emergingtravel.com/docs/overview/ Вся интеграция одним документом: https://mcp-everything.ru/integrations/ostrovok-etg.md