Développeurs
Connectez le HM ID à votre propre système via REST API, dump quotidien et webhook. Les exemples ci-dessous présentent l'API v1, que vous pouvez essayer dans la 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
}' Authentification
Chaque requête est envoyée en HTTPS avec l'en-tête X-API-Key. Les clés du sandbox et de la production sont distinctes.
X-API-Key: $HM_API_KEY
Content-Type: application/json
Accept-Language: tr Endpoints
-
POST /v1/matchRecherche un hôtel par nom, adresse et coordonnées ; renvoie le HM ID et le score de confiance (Find Match API).
-
GET /v1/hotels/{hm_id}Renvoie la fiche standard de l'hôtel, ses codes fournisseurs et ses ID croisés.
-
GET /v1/suppliers/{supplier}/codes/{code}Convertit un code fournisseur en HM ID.
-
POST /v1/rooms/mapDécompose les noms de chambres en type, catégorie, vue, lit et capacité ; regroupe les chambres identiques.
-
POST /v1/boards/mapConvertit les libellés de pension en code standard (RO, BB, HB, FB, AI, UAI…).
-
GET /v1/destinations/{id}Renvoie la hiérarchie pays → région → département → zone de villégiature et les codes de destination des fournisseurs.
-
GET /v1/hotels/{hm_id}/contentRenvoie la description et la fiche technique multilingues.
-
GET /v1/dumps/latestRenvoie les adresses des fichiers de dump quotidiens complets et delta (CSV, JSON, Parquet).
Exemples de requêtes et de réponses
{
"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" }
]
} Les exemples de code sont indicatifs ; les noms de champs peuvent changer lors de la publication de la v1.
Options de livraison
-
REST API
Pour les requêtes en temps réel et Find Match. Réponses JSON, pagination et endpoints versionnés.
-
Dump quotidien
Fichiers complets et delta : CSV, JSON ou Parquet. Pour le chargement en masse dans votre propre base de données.
-
WebhookBientôt
Notification pour les hôtels fermés, fusionnés et nouveaux. Prévu.
Sandbox gratuit de 14 jours
Testez tous les endpoints avec 1 000 appels API par mois et des données d'exemple. Aucune carte bancaire requise.
SDKBientôt disponible
Des bibliothèques clientes .NET, PHP, Node.js et Python sont en préparation. D'ici là, vous pouvez l'utiliser en HTTP simple depuis n'importe quel langage.
- .NET
- PHP
- Node.js
- Python
Limites de débit
Les limites de requêtes dépendent de votre plan et sont indiquées dans votre devis. Pour les traitements en masse, le dump est recommandé.
Obtenez votre devis sur mesure
Envoyez votre demande en trois étapes ; nous vous transmettons le devis à votre e-mail professionnel. La demande n'engage à rien.