Разработчикам
Подключите HM ID к своей системе через REST API, ежедневный дамп и webhook. Приведённые ниже примеры показывают API v1, который можно попробовать в песочнице.
curl -X POST https://api.hotelmapping.org/v1/match \
-H "X-API-Key: $HM_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"name": "SUNSET BAY RESORT SPA",
"address": "Belek Turizm Merkezi, Serik",
"country": "TR",
"lat": 36.8541,
"lng": 31.0552
}' Аутентификация
Каждый запрос отправляется по HTTPS с заголовком X-API-Key. Ключи для sandbox и боевой среды разные.
X-API-Key: $HM_API_KEY
Content-Type: application/json
Accept-Language: tr Эндпоинты
-
POST /v1/matchИщет отель по названию, адресу и координатам; возвращает HM ID и оценку совпадения (Find Match API).
-
GET /v1/hotels/{hm_id}Возвращает стандартную запись отеля, коды поставщиков и перекрёстные ID.
-
GET /v1/suppliers/{supplier}/codes/{code}Преобразует код поставщика в HM ID.
-
POST /v1/rooms/mapРазбирает названия номеров по типу, категории, виду, кровати и вместимости; группирует одинаковые номера.
-
POST /v1/boards/mapПреобразует написания типов питания в стандартный код (RO, BB, HB, FB, AI, UAI…).
-
GET /v1/destinations/{id}Возвращает иерархию страна → регион → район → курортная зона и коды направлений поставщиков.
-
GET /v1/hotels/{hm_id}/contentВозвращает многоязычное описание и factsheet.
-
GET /v1/dumps/latestВозвращает адреса ежедневных полных и дельта-дампов (CSV, JSON, Parquet).
Примеры запросов и ответов
{
"hm_id": "HM-1048213",
"confidence": 0.991,
"decision": "auto_match",
"name": "Sunset Bay Resort & Spa",
"destination_id": "TR-07-SERIK-BELEK",
"external_ids": { "client": "OTL-2231" }
} POST /v1/rooms/map
{
"hm_id": "HM-1048213",
"rooms": ["Dbl Sea View Balcony", "DOUBLE ROOM SEASIDE W/ BALCONY"]
}
// → 200
{
"groups": [{
"room_id": "HM-1048213-R03",
"type": "room",
"class": "standard",
"view": "sea",
"bed": "double",
"features": ["balcony"],
"max_occupancy": 3,
"matched": ["Dbl Sea View Balcony", "DOUBLE ROOM SEASIDE W/ BALCONY"]
}]
} POST /v1/boards/map
{ "values": ["Ultra Herşey Dahil", "UALL", "Soft All Inc.", "HB+"] }
// → 200
{
"results": [
{ "input": "Ultra Herşey Dahil", "code": "UAI", "score": 0.99, "decision": "auto_match" },
{ "input": "UALL", "code": "UAI", "score": 0.93, "decision": "review" },
{ "input": "Soft All Inc.", "code": "SAI", "score": 0.98, "decision": "auto_match" },
{ "input": "HB+", "code": "HB+", "score": 1.0, "decision": "auto_match" }
]
} Примеры кода носят иллюстративный характер; названия полей могут измениться в релизе v1.
Варианты доставки
-
REST API
Для мгновенных запросов и Find Match. Ответ в JSON, постраничная выдача и версионируемые эндпоинты.
-
Ежедневный дамп
Полные и дельта-файлы: CSV, JSON или Parquet. Для массовой загрузки в вашу собственную базу данных.
-
WebhookСкоро
Уведомления о закрытых, объединённых и новых отелях. Планируется.
14-дневный бесплатный sandbox
Испытайте все эндпоинты с 1 000 API-запросов в месяц и примерами данных. Банковская карта не нужна.
SDKСкоро
Клиентские библиотеки для .NET, PHP, Node.js и Python находятся в разработке. До их выхода вы можете работать с любого языка через обычный HTTP.
- .NET
- PHP
- Node.js
- Python
Лимиты запросов
Лимиты запросов зависят от вашего плана и указываются в коммерческом предложении. Для массовых задач рекомендуется дамп.
Получите индивидуальное предложение
Отправьте запрос в три шага, и мы пришлём предложение на ваш рабочий e-mail. Запрос ни к чему не обязывает.