Desarrolladores

Conecte el HM ID a su propio sistema mediante REST API, dump diario y webhook. Los ejemplos siguientes muestran la API v1, que puede probar en el sandbox.

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
  }'

Autenticación

Cada solicitud se envía por HTTPS y con la cabecera X-API-Key. Las claves de sandbox y de producción son distintas.

Headers
X-API-Key: $HM_API_KEY
Content-Type: application/json
Accept-Language: tr

Endpoints

  • POST /v1/match

    Busca un hotel por nombre, dirección y coordenadas; devuelve el HM ID y la puntuación de confianza (Find Match API).

  • GET /v1/hotels/{hm_id}

    Devuelve el registro estándar del hotel, sus códigos de proveedor y sus ID cruzados.

  • GET /v1/suppliers/{supplier}/codes/{code}

    Convierte un código de proveedor en HM ID.

  • POST /v1/rooms/map

    Descompone los nombres de habitación en tipo, categoría, vista, cama y capacidad; agrupa las habitaciones equivalentes.

  • POST /v1/boards/map

    Convierte las grafías de régimen alimenticio en un código estándar (RO, BB, HB, FB, AI, UAI…).

  • GET /v1/destinations/{id}

    Devuelve la jerarquía país → provincia → distrito → zona turística y los códigos de destino de los proveedores.

  • GET /v1/hotels/{hm_id}/content

    Devuelve la descripción y la ficha técnica en varios idiomas.

  • GET /v1/dumps/latest

    Devuelve las direcciones de los archivos de dump diario completo y delta (CSV, JSON, Parquet).

Ejemplos de solicitud y respuesta

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" }
  ]
}

Los ejemplos de código son ilustrativos; los nombres de los campos pueden cambiar en la versión v1.

Opciones de entrega

  • REST API

    Para consultas en tiempo real y Find Match. Respuesta JSON, paginación y endpoints versionados.

  • Dump diario

    Archivos completos y delta: CSV, JSON o Parquet. Para la carga masiva en su propia base de datos.

  • WebhookPróximamente

    Notificaciones de hoteles cerrados, fusionados y nuevos. Previsto.

14 días de sandbox gratuito

Pruebe todos los endpoints con 1.000 llamadas a la API al mes y datos de ejemplo. No se necesita tarjeta de crédito.

SDKPróximamente

Estamos preparando bibliotecas cliente para .NET, PHP, Node.js y Python. Hasta entonces, puede usarla desde cualquier lenguaje mediante HTTP simple.

  • .NET
  • PHP
  • Node.js
  • Python

Límites de velocidad

Los límites de solicitudes dependen de su plan y se indican en su presupuesto. Para trabajos masivos se recomienda el dump.

Reciba su presupuesto a medida

Envíe su solicitud en tres pasos; le enviaremos el presupuesto a su correo profesional. La solicitud no es vinculante.