Разработчикам

Подключите HM ID к своей системе через REST API, ежедневный дамп и webhook. Приведённые ниже примеры показывают API v1, который можно попробовать в песочнице.

POST /v1/match
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 и боевой среды разные.

Headers
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).

Примеры запросов и ответов

POST /v1/match → 200
{
  "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
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
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. Запрос ни к чему не обязывает.