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.

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

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.

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

Endpoints

  • POST /v1/match

    Recherche 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/map

    Décompose les noms de chambres en type, catégorie, vue, lit et capacité ; regroupe les chambres identiques.

  • POST /v1/boards/map

    Convertit 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}/content

    Renvoie la description et la fiche technique multilingues.

  • GET /v1/dumps/latest

    Renvoie les adresses des fichiers de dump quotidiens complets et delta (CSV, JSON, Parquet).

Exemples de requêtes et de réponses

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

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.