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.
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.
X-API-Key: $HM_API_KEY
Content-Type: application/json
Accept-Language: tr Endpunkte
-
POST /v1/matchSucht 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/mapZerlegt Zimmerbezeichnungen in Typ, Kategorie, Ausblick, Bett und Kapazität; gruppiert gleiche Zimmer.
-
POST /v1/boards/mapWandelt 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}/contentLiefert mehrsprachige Beschreibung und Factsheet.
-
GET /v1/dumps/latestLiefert die Adressen der täglichen Voll- und Delta-Dump-Dateien (CSV, JSON, Parquet).
Beispielanfragen und -antworten
{
"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" }
]
} 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.