Hotel-API-integratie

RateHawk API-integratie: van API key tot live hotelboekingen

Koppel uw RateHawk-account aan PHPTRAVELS en verkoop hotels en appartementen van RateHawk op uw eigen website en in uw agentenportaal. De connector is klaar: voer uw API-sleutels in, importeer de hoteldatabase, stel uw marge in en doorloop de certificering van RateHawk.

  • Kant-en-klare RateHawk-connector
  • ETG API v3
  • Import van de hoteldump
  • Uw marge op nettotarieven

De leverancier

Wat RateHawk is en waarom bureaus het koppelen

RateHawk is het B2B-boekingsplatform van Emerging Travel Group (ETG) voor reisagenten, touroperators en reisbedrijven. Partners boeken hotels, appartementen en andere accommodaties tegen nettotarieven, in het eigen portaal van RateHawk of via de API.

De API heet ETG API. De huidige versie is v3, een REST API met JSON-verzoeken en -antwoorden voor zoeken, boeken en annuleren. PHPTRAVELS levert een RateHawk-connector in de accommodatiemodule, zodat resultaten van RateHawk naast uw andere hotelleveranciers en uw eigen contracten verschijnen.

Gerelateerd:VerblijvenHotelboekingsmachineReis-API's

Leveranciersprofiel
Bedrijf
RateHawk, onderdeel van Emerging Travel Group
Type
B2B-accommodatieplatform voor reisprofessionals
Aanbod
Meer dan 2,6 miljoen accommodatieopties, volgens RateHawk
API-partners
Meer dan 700 API-klanten, volgens RateHawk in 2024
API
ETG API v3 · REST · JSON
In PHPTRAVELS
Kant-en-klare connector in de accommodatiemodule

De boekingsflow van ETG API v3

Zo verloopt een RateHawk-boeking, fase voor fase

Elke RateHawk-boeking doorloopt dezelfde vijf fasen. Per fase ziet u de ETG API-calls erachter en wat PHPTRAVELS voor u doet.

  1. 01

    Zoeken

    ETG API-calls

    Zoeken op regio · op geocoördinaten · op hotel-ID's

    PHPTRAVELS

    Zoekt op stad, kaartgebied of hotellijst, met data, gasten en het woonland van de reiziger, en toont live nettotarieven inclusief uw marge.

  2. 02

    Hotelpagina

    ETG API-calls

    Retrieve hotelpage

    PHPTRAVELS

    Laadt alle kamers en tarieven van het gekozen hotel: verzorging, belastingen, annuleringsvoorwaarden en betaalwijze.

  3. 03

    Voorboeking

    ETG API-calls

    Prebook rate · Retrieve rate info

    PHPTRAVELS

    Controleert vlak voor de betaling of het gekozen tarief nog tegen die prijs beschikbaar is, en stopt de checkout als het is gewijzigd.

  4. 04

    Boeken

    ETG API-calls

    Boekingsproces aanmaken, starten en controleren

    PHPTRAVELS

    Maakt de boeking aan, stuurt de gastgegevens door, volgt de status tot de bevestiging en slaat het RateHawk-order-ID op.

  5. 05

    Na de boeking

    ETG API-calls

    Retrieve bookings · Cancel booking · Status-webhooks

    PHPTRAVELS

    Verstuurt de voucher, toont de boeking in de admin en het klantaccount en handelt annuleringen af volgens de voorwaarden van het tarief.

Statische data

Importeer de RateHawk-hoteldatabase één keer en houd die actueel

Zoekresultaten bevatten alleen tarieven. Namen, adressen, foto's, faciliteiten en beschrijvingen komen uit de statische data van ETG, die PHPTRAVELS in uw hotelpagina's importeert.

  • Regiodump

    Landen, steden en gebieden, zodat reizigers op bestemming kunnen zoeken.

  • Hoteldump

    Het volledige hotelcontentbestand: namen, adressen, coördinaten, foto's, faciliteiten en beschrijvingen.

  • Incrementele dump

    Alleen wat sinds de laatste import is gewijzigd, zodat de catalogus actueel blijft zonder volledige herlaadbeurt.

  • Reviewdump

    Reviewscores en -teksten van gasten voor uw hotelpagina's, als uw overeenkomst die omvat.

Import van hotelcontent
  • Regiodump100%
  • Hoteldump100%
  • Incrementele dump64%
  • Reviewdump30%

Voorbeeldscherm. Aantallen hangen af van uw account en talen.

Naast de dumpbestanden biedt ETG ook een Content API voor hoteldata op aanvraag.

API key en sandbox

Zo werkt de authenticatie van de RateHawk API

De ETG API gebruikt HTTP Basic-authenticatie. Uw key ID is de gebruikersnaam en uw API key het wachtwoord, bij elk verzoek via HTTPS verzonden.

Een zoekverzoek in de sandbox (voorbeeld)
 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
Twee hosts
Sandbox: api-sandbox.ratehawk.com. Test en productie: api.ratehawk.com. De oude worldota.net-hosts zijn verouderd.
Het testhotel is echt
Met testsleutels mag u alleen het testhotel met hid 8473727 boeken, en die boeking is echt, met echte financiële verantwoordelijkheid. Annuleer haar direct na de test.
Sleutels blijven op de server
PHPTRAVELS bewaart de key ID en API key in de serverconfiguratie, nooit in de browser of in een app.
Woonland telt
Tarieven hangen af van het woonland van de reiziger, daarom stuurt de connector dat bij elke zoekopdracht mee.

Instellen in PHPTRAVELS

Stel de RateHawk-connector in vier stappen in

Geen code nodig: de connector configureert u in het beheerpaneel.

  1. 01Voer uw API-sleutels inPlak de key ID en API key van RateHawk, eerst voor de sandbox en later voor productie.
  2. 02Importeer de hoteldatabaseLaad de regio- en hoteldumps en plan daarna de incrementele updates.
  3. 03Stel marge en valuta inProcentuele of vaste marges, per kanaal, agentengroep of bestemming, in de valuta waarin u verkoopt.
  4. 04Testen en live gaanVoer de testboeking en -annulering uit, haal de certificering en schakel over naar de productiesleutels.
Leveranciers › RateHawkRateHawk

Omgeving

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

Key ID4127
API key••••••••••••••••
Marge12% op nettotarieven
ValutaUSD · EUR · GBP
Standaard woonlandGB

Voorbeeld van een instellingenscherm.

Certificering

Van overeenkomst tot productietoegang

RateHawk geeft pas toegang tot productie als de overeenkomst is getekend en uw integratie de certificering heeft doorstaan.

  1. 1

    Teken de API-overeenkomst

    U

    Neem als reisbedrijf contact op met RateHawk en teken de API-overeenkomst voor uw markten.

  2. 2

    Ontvang de sandboxsleutels

    RateHawk

    RateHawk verstrekt een key ID en API key voor de sandbox.

  3. 3

    Koppelen en importeren

    PHPTRAVELS

    De sleutels gaan in PHPTRAVELS, de statische data wordt geïmporteerd en de marges worden ingesteld.

  4. 4

    Haal de certificering

    RateHawk

    RateHawk controleert de integratie, inclusief de boekings-, status- en annuleringsflow.

  5. 5

    Productietoegang

    U

    De productiesleutels gaan in de admin en de live boekingen beginnen.

Portaal, API of boekingssysteem

Drie manieren om RateHawk-hotels te verkopen

Agenten kunnen vandaag al boeken op de website van RateHawk zelf. De API, binnen uw eigen boekingssysteem, brengt RateHawk-hotels onder uw merk.

  • RateHawk-website

    Wie boekt
    Uw agenten, één boeking tegelijk
    Wiens merk
    RateHawk
    Wat het vraagt
    Registreren als agent en inloggen
  • Eigen API-ontwikkeling

    Wie boekt
    Uw klanten en agenten, online
    Wiens merk
    Het uwe
    Wat het vraagt
    Maanden ontwikkeling en certificering
  • PHPTRAVELS met RateHawk

    Wie boekt
    Uw klanten en agenten, online
    Wiens merk
    Het uwe
    Wat het vraagt
    Configuratie, contentimport en certificering

Multi-leverancier

RateHawk naast uw andere hotelleveranciers

RateHawk is één leverancier in de accommodatiemodule. Dezelfde zoekopdracht kan uw andere hotel-API's en uw eigen contracten omvatten, met marges en routering per leverancier.

  • Agoda
  • Amadeus
  • Booking.com
  • Hotelbeds
  • Hotelston
  • RateHawk
  • Stuba
  • TBO Holidays
  • Travelport
  • Wanderbeds

Lees de gids voor agenten

FAQ

Vragen over RateHawk API-integratie

Wat bureaus vragen voordat ze RateHawk koppelen.

Praat met sales

RateHawk publiceert geen vergoeding voor API-toegang. U tekent een API-overeenkomst en verkoopt de hotels tegen nettotarieven met uw eigen marge. Uw kosten zijn uw boekingssoftware, hosting en betalingen.

Neem als reisbedrijf contact op met RateHawk en teken de API-overeenkomst. RateHawk verstrekt dan een key ID en API key voor de sandbox, en na de certificering de productiesleutels.

De documentatie van de ETG API staat online op docs.emergingtravel.com, met de B2B API, de Content API en de handleidingen voor sandbox en certificering. Er is geen aparte pdf om te downloaden; de online documentatie is de actuele versie.

De ETG API is de API van Emerging Travel Group, het bedrijf achter RateHawk. RateHawk API-integratie en ETG API-integratie betekenen hetzelfde; de huidige versie is v3.

PHPTRAVELS is een eenmalige licentie vanaf US$ 2.499 met de volledige broncode, en de RateHawk-connector zit in de accommodatiemodule. Uw commerciële voorwaarden met RateHawk spreekt u af met RateHawk.

Ja, op api-sandbox.ratehawk.com. Let op: met testsleutels mag u alleen het testhotel met hid 8473727 boeken, en die boeking is echt, dus annuleer haar direct na het testen.

Agenten registreren zich en loggen in op ratehawk.com om in het portaal te boeken. API-toegang staat daar los van: die gebruikt de key ID en API key uit uw overeenkomst, niet uw portaallogin.

De connector bestaat al, dus de tijd gaat naar de overeenkomst, het invoeren van de sleutels, het importeren van de hotelcontent en de certificering door RateHawk, niet naar ontwikkeling.

Ja. Dezelfde connector bedient uw B2C-website en uw B2B-agentenportaal, met aparte marges per kanaal en agentengroep.

Elk tarief heeft eigen annuleringsvoorwaarden, die vóór de betaling worden getoond. Annuleringen lopen vanuit de admin of het klantaccount via de annuleringscall, volgens die voorwaarden.