Entwickler

Binden Sie die HM ID per REST API, täglichem Dump und Webhook in Ihr eigenes System ein. Die folgenden Beispiele zeigen die API v1, die Sie in der Sandbox testen können.

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

Authentifizierung

Jede Anfrage wird über HTTPS und mit dem Header X-API-Key gesendet. Die Schlüssel für Sandbox und Live-Umgebung sind getrennt.

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

Endpunkte

  • POST /v1/match

    Sucht ein Hotel anhand von Name, Adresse und Koordinaten; liefert HM ID und Match-Score (Find Match API).

  • GET /v1/hotels/{hm_id}

    Liefert den Standarddatensatz des Hotels, die Anbietercodes und die Querverweis-IDs.

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

    Wandelt einen Anbietercode in die HM ID um.

  • POST /v1/rooms/map

    Zerlegt Zimmerbezeichnungen in Typ, Kategorie, Ausblick, Bett und Kapazität; gruppiert gleiche Zimmer.

  • POST /v1/boards/map

    Wandelt Verpflegungsschreibweisen in den Standardcode (RO, BB, HB, FB, AI, UAI…) um.

  • GET /v1/destinations/{id}

    Liefert die Hierarchie Land → Region → Bezirk → Ferienregion und die Destinationscodes der Anbieter.

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

    Liefert mehrsprachige Beschreibung und Factsheet.

  • GET /v1/dumps/latest

    Liefert die Adressen der täglichen Voll- und Delta-Dump-Dateien (CSV, JSON, Parquet).

Beispielanfragen und -antworten

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

Die Codebeispiele sind exemplarisch; Feldnamen können sich mit dem v1-Release ändern.

Liefermöglichkeiten

  • REST API

    Für Echtzeitabfragen und Find Match. JSON-Antwort, Paginierung und versionierte Endpunkte.

  • Täglicher Dump

    Voll- und Delta-Dateien: CSV, JSON oder Parquet. Für den Massenimport in Ihre eigene Datenbank.

  • WebhookDemnächst

    Benachrichtigung bei geschlossenen, zusammengeführten und neuen Hotels. Geplant.

14 Tage kostenlose Sandbox

Testen Sie alle Endpunkte mit 1.000 API-Aufrufen pro Monat und Beispieldaten. Keine Kreditkarte erforderlich.

SDKsDemnächst

Client-Bibliotheken für .NET, PHP, Node.js und Python sind in Vorbereitung. Bis dahin können Sie die API aus jeder Sprache per einfachem HTTP nutzen.

  • .NET
  • PHP
  • Node.js
  • Python

Ratenbegrenzung

Die Anfragelimits hängen von Ihrem Plan ab und werden in Ihrem Angebot genannt. Für Massenverarbeitung empfehlen wir den Dump.

Individuelles Angebot erhalten

Senden Sie Ihre Anfrage in drei Schritten; wir schicken das Angebot an Ihre geschäftliche E-Mail. Die Anfrage ist unverbindlich.