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.
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.
X-API-Key: $HM_API_KEY
Content-Type: application/json
Accept-Language: tr Endpoints
-
POST /v1/matchBusca 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/mapDescompone los nombres de habitación en tipo, categoría, vista, cama y capacidad; agrupa las habitaciones equivalentes.
-
POST /v1/boards/mapConvierte 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}/contentDevuelve la descripción y la ficha técnica en varios idiomas.
-
GET /v1/dumps/latestDevuelve las direcciones de los archivos de dump diario completo y delta (CSV, JSON, Parquet).
Ejemplos de solicitud y respuesta
{
"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" }
]
} 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.