Live-Demo

Hotel-API-Integration

RateHawk-API-Integration: vom API-Key zu Live-Hotelbuchungen

Verbinden Sie Ihr RateHawk-Konto mit PHPTRAVELS und verkaufen Sie RateHawk-Hotels und -Apartments auf Ihrer eigenen Website und in Ihrem Agentenportal. Der Connector ist fertig: API-Schlüssel hinterlegen, Hoteldatenbank importieren, Aufschlag festlegen und die Zertifizierung von RateHawk durchlaufen.

  • Fertiger RateHawk-Connector
  • ETG API v3
  • Import des Hotel-Dumps
  • Ihr Aufschlag auf Nettoraten

Der Anbieter

Was RateHawk ist und warum Agenturen es anbinden

RateHawk ist die B2B-Buchungsplattform von Emerging Travel Group (ETG) für Reisebüros, Reiseveranstalter und Reiseunternehmen. Partner buchen Hotels, Apartments und andere Unterkünfte zu Nettoraten, entweder im eigenen Portal von RateHawk oder über dessen API.

Die API heißt ETG API. Die aktuelle Version ist v3, eine REST-API mit JSON-Anfragen und -Antworten für Suche, Buchung und Stornierung. PHPTRAVELS liefert einen RateHawk-Connector im Unterkunftsmodul mit, sodass RateHawk-Ergebnisse neben Ihren anderen Hotelanbietern und Ihren eigenen Verträgen erscheinen.

Verwandt:UnterkünfteHotel-BuchungsmaschineReise-APIs

Anbieter-Steckbrief
Unternehmen
RateHawk, Teil der Emerging Travel Group
Typ
B2B-Unterkunftsplattform für Reiseprofis
Angebot
Über 2,6 Millionen Unterkunftsoptionen, laut RateHawk
API-Partner
Über 700 API-Kunden, laut Angabe von RateHawk aus dem Jahr 2024
API
ETG API v3 · REST · JSON
In PHPTRAVELS
Fertiger Connector im Unterkunftsmodul

Der Buchungsablauf der ETG API v3

So läuft eine RateHawk-Buchung ab, Phase für Phase

Jede RateHawk-Buchung durchläuft dieselben fünf Phasen. Zu jeder sehen Sie die zugehörigen ETG-API-Aufrufe und was PHPTRAVELS für Sie übernimmt.

  1. 01

    Suche

    ETG-API-Aufrufe

    Suche nach Region · nach Geokoordinaten · nach Hotel-IDs

    PHPTRAVELS

    Sucht nach Stadt, Kartenausschnitt oder Hotelliste, mit Reisedaten, Gästen und Wohnsitzland des Reisenden, und zeigt Live-Nettoraten inklusive Ihres Aufschlags.

  2. 02

    Hotelseite

    ETG-API-Aufrufe

    Retrieve hotelpage

    PHPTRAVELS

    Lädt alle Zimmer und Raten des gewählten Hotels: Verpflegung, Steuern, Stornobedingungen und Zahlungsart.

  3. 03

    Vorabbuchung

    ETG-API-Aufrufe

    Prebook rate · Retrieve rate info

    PHPTRAVELS

    Prüft kurz vor der Zahlung, ob die gewählte Rate zu diesem Preis noch verfügbar ist, und stoppt den Checkout, falls sie sich geändert hat.

  4. 04

    Buchung

    ETG-API-Aufrufe

    Buchungsprozess anlegen, starten und prüfen

    PHPTRAVELS

    Legt die Buchung an, übermittelt die Gästedaten, verfolgt den Status bis zur Bestätigung und speichert die RateHawk-Auftrags-ID.

  5. 05

    Nach der Buchung

    ETG-API-Aufrufe

    Retrieve bookings · Cancel booking · Status-Webhooks

    PHPTRAVELS

    Versendet den Voucher, zeigt die Buchung im Admin und im Kundenkonto und wickelt Stornierungen gemäß den Bedingungen der Rate ab.

Statische Daten

Die RateHawk-Hoteldatenbank einmal importieren und aktuell halten

Suchergebnisse enthalten nur Raten. Namen, Adressen, Fotos, Ausstattung und Beschreibungen stammen aus den statischen Daten von ETG, die PHPTRAVELS in Ihre Hotelseiten importiert.

  • Regionen-Dump

    Länder, Städte und Gebiete, damit Reisende nach Reiseziel suchen können.

  • Hotel-Dump

    Die vollständige Hotel-Content-Datei: Namen, Adressen, Koordinaten, Fotos, Ausstattung und Beschreibungen.

  • Inkrementeller Dump

    Nur die Änderungen seit dem letzten Import, damit der Katalog ohne kompletten Neuimport aktuell bleibt.

  • Bewertungs-Dump

    Bewertungspunkte und -texte von Gästen für Ihre Hotelseiten, sofern Ihre Vereinbarung sie umfasst.

Import von Hotel-Content
  • Regionen-Dump100%
  • Hotel-Dump100%
  • Inkrementeller Dump64%
  • Bewertungs-Dump30%

Beispielansicht. Die Zahlen hängen von Ihrem Konto und Ihren Sprachen ab.

Neben den Dump-Dateien bietet ETG auch eine Content API für Hoteldaten auf Abruf.

API-Key und Sandbox

So funktioniert die Authentifizierung der RateHawk-API

Die ETG API nutzt HTTP Basic-Authentifizierung. Ihre Key ID ist der Benutzername und Ihr API-Key das Passwort; beide werden bei jeder Anfrage über HTTPS gesendet.

Eine Suchanfrage in der Sandbox (Beispiel)
 1# HTTP Basic: key ID = username, API key = password 2curl -u "$KEY_ID:$API_KEY" \ 3  -H "Content-Type: application/json" \ 4  https://api-sandbox.ratehawk.com/api/b2b/v3/search/serp/hotels/ \ 5  -d '{ 6    "checkin": "2026-11-14", 7    "checkout": "2026-11-16", 8    "residency": "gb", 9    "language": "en",10    "currency": "USD",11    "guests": [{ "adults": 2, "children": [] }],12    "hids": [8473727]13  }'1415# 8473727 = the test hotel: a real booking if you book it
HTTP BasicETG API v3api-sandbox.ratehawk.com → api.ratehawk.com
Zwei Hosts
Sandbox: api-sandbox.ratehawk.com. Test und Produktion: api.ratehawk.com. Die alten worldota.net-Hosts sind veraltet.
Das Testhotel ist echt
Mit Testschlüsseln darf nur das Testhotel mit hid 8473727 gebucht werden, und diese Buchung ist echt, mit echter finanzieller Verantwortung. Stornieren Sie sie direkt nach dem Test.
Schlüssel bleiben auf dem Server
PHPTRAVELS speichert Key ID und API-Key in der Serverkonfiguration, nie im Browser oder in einer App.
Der Wohnsitz zählt
Die Raten hängen vom Wohnsitzland des Reisenden ab, deshalb sendet der Connector es bei jeder Suche mit.

Einrichtung in PHPTRAVELS

Den RateHawk-Connector in vier Schritten einrichten

Kein Code nötig: Der Connector wird im Admin-Bereich konfiguriert.

  1. 01API-Schlüssel hinterlegenKey ID und API-Key von RateHawk einfügen, zuerst für die Sandbox, später für die Produktion.
  2. 02Hoteldatenbank importierenRegionen- und Hotel-Dumps laden und anschließend die inkrementellen Updates planen.
  3. 03Aufschlag und Währung festlegenProzentuale oder feste Aufschläge, pro Kanal, Agentengruppe oder Reiseziel, in den Währungen, in denen Sie verkaufen.
  4. 04Testen und live gehenTestbuchung und Teststornierung durchführen, die Zertifizierung bestehen und dann auf die Produktionsschlüssel wechseln.
Anbieter › RateHawkRateHawk

Umgebung

https://api-sandbox.ratehawk.comhttps://api.ratehawk.com

Key ID4127
API-Key••••••••••••••••
Aufschlag12 % auf Nettoraten
WährungUSD · EUR · GBP
Standard-WohnsitzlandGB

Beispiel einer Einstellungsseite.

Zertifizierung

Vom Vertrag zum Produktionszugang

RateHawk schaltet die Produktion erst frei, wenn der Vertrag unterschrieben ist und Ihre Integration die Zertifizierung bestanden hat.

  1. 1

    API-Vertrag unterzeichnen

    Sie

    Kontaktieren Sie RateHawk als Reiseunternehmen und unterzeichnen Sie den API-Vertrag für Ihre Märkte.

  2. 2

    Sandbox-Schlüssel erhalten

    RateHawk

    RateHawk stellt eine Key ID und einen API-Key für die Sandbox aus.

  3. 3

    Anbinden und importieren

    PHPTRAVELS

    Die Schlüssel werden in PHPTRAVELS hinterlegt, die statischen Daten importiert und die Aufschläge festgelegt.

  4. 4

    Zertifizierung bestehen

    RateHawk

    RateHawk prüft die Integration, einschließlich Buchungs-, Status- und Stornierungsablauf.

  5. 5

    Produktionszugang

    Sie

    Die Produktionsschlüssel kommen in den Admin, und die Live-Buchungen beginnen.

Portal, API oder Buchungsmaschine

Drei Wege, RateHawk-Hotels zu verkaufen

Agenten können schon heute auf der Website von RateHawk buchen. Erst die API in Ihrer eigenen Buchungsmaschine bringt RateHawk-Hotels unter Ihre Marke.

  • RateHawk-Website

    Wer bucht
    Ihre Agenten, Buchung für Buchung
    Wessen Marke
    RateHawk
    Was nötig ist
    Als Agent registrieren und anmelden

  • Eigene API-Entwicklung

    Wer bucht
    Ihre Kunden und Agenten, online
    Wessen Marke
    Ihre
    Was nötig ist
    Monate an Entwicklung und Zertifizierung

  • PHPTRAVELS mit RateHawk

    Wer bucht
    Ihre Kunden und Agenten, online
    Wessen Marke
    Ihre
    Was nötig ist
    Konfiguration, Content-Import und Zertifizierung

Multi-Anbieter

RateHawk neben Ihren anderen Hotelanbietern

RateHawk ist ein Anbieter im Unterkunftsmodul. Dieselbe Suche kann Ihre anderen Hotel-APIs und Ihre eigenen Verträge einschließen, mit Aufschlägen und Routing pro Anbieter.

  • Agoda
  • Amadeus
  • Booking.com
  • Hotelbeds
  • Hotelston
  • RateHawk
  • Stuba
  • TBO Holidays
  • Travelport
  • Wanderbeds
Preise ansehenHotel-Demo testen

Zum Leitfaden für Agenturen

FAQ

Fragen zur RateHawk-API-Integration

Was Agenturen fragen, bevor sie RateHawk anbinden.

Vertrieb kontaktieren

RateHawk veröffentlicht keine Gebühr für den API-Zugang. Sie unterzeichnen einen API-Vertrag und verkaufen die Hotels zu Nettoraten mit Ihrem eigenen Aufschlag. Ihre Kosten sind Ihre Buchungssoftware, das Hosting und die Zahlungsabwicklung.

Kontaktieren Sie RateHawk als Reiseunternehmen und unterzeichnen Sie den API-Vertrag. RateHawk stellt dann eine Key ID und einen API-Key für die Sandbox aus und nach der Zertifizierung die Produktionsschlüssel.

Die Dokumentation der ETG API ist online unter docs.emergingtravel.com, mit der B2B API, der Content API sowie Leitfäden zu Sandbox und Zertifizierung. Ein separates PDF zum Herunterladen gibt es nicht; die Online-Dokumentation ist die aktuelle Version.

Die ETG API ist die API der Emerging Travel Group, des Unternehmens hinter RateHawk. RateHawk-API-Integration und ETG-API-Integration meinen dasselbe; die aktuelle Version ist v3.

PHPTRAVELS ist eine einmalige Lizenz ab 2.499 $ mit vollständigem Quellcode, und der RateHawk-Connector ist im Unterkunftsmodul enthalten. Ihre kommerziellen Konditionen vereinbaren Sie direkt mit RateHawk.

Ja, unter api-sandbox.ratehawk.com. Beachten Sie, dass Testschlüssel nur das Testhotel mit hid 8473727 buchen dürfen und diese Buchung echt ist; stornieren Sie sie daher direkt nach dem Test.

Agenten registrieren sich auf ratehawk.com und melden sich dort an, um im Portal zu buchen. Der API-Zugang ist davon getrennt: Er nutzt Key ID und API-Key aus Ihrem Vertrag, nicht Ihr Portal-Login.

Der Connector existiert bereits. Die Zeit fließt also in den Vertrag, das Hinterlegen der Schlüssel, den Import des Hotel-Contents und die Zertifizierung durch RateHawk, nicht in die Entwicklung.

Ja. Derselbe Connector bedient Ihre B2C-Website und Ihr B2B-Agentenportal, mit getrennten Aufschlägen pro Kanal und Agentengruppe.

Jede Rate hat ihre eigenen Stornobedingungen, die vor der Zahlung angezeigt werden. Stornierungen laufen aus dem Admin oder dem Kundenkonto über den Stornierungsaufruf, gemäß diesen Bedingungen.

Weiter entdecken

Mehr zur Plattform