Demo live

Integrazione API alberghiera

Integrazione API RateHawk: dalla API key alle prenotazioni hotel live

Collega il tuo account RateHawk a PHPTRAVELS e vendi hotel e appartamenti RateHawk sul tuo sito e sul tuo portale agenti. Il connettore è pronto: inserisci le chiavi API, importa il database hotel, imposta il tuo ricarico e completa la certificazione di RateHawk.

  • Connettore RateHawk pronto
  • ETG API v3
  • Import del dump hotel
  • Il tuo ricarico sulle tariffe nette

Il fornitore

Che cos'è RateHawk e perché le agenzie lo collegano

RateHawk è la piattaforma di prenotazione B2B di Emerging Travel Group (ETG) per agenti di viaggio, tour operator e aziende di viaggio. I partner prenotano hotel, appartamenti e altre strutture a tariffe nette, nel portale di RateHawk oppure tramite la sua API.

L'API si chiama ETG API. La versione attuale è la v3, un'API REST con richieste e risposte in JSON che copre ricerca, prenotazione e cancellazione. PHPTRAVELS include un connettore RateHawk nel modulo alloggi, così i risultati RateHawk compaiono accanto agli altri tuoi fornitori alberghieri e ai tuoi contratti diretti.

Correlati:HotelMotore di prenotazione hotelAPI di viaggio

Scheda fornitore
Azienda
RateHawk, parte di Emerging Travel Group
Tipo
Piattaforma B2B di alloggi per professionisti del turismo
Inventario
Oltre 2,6 milioni di soluzioni di alloggio, secondo RateHawk
Partner API
Oltre 700 clienti API, secondo quanto dichiarato da RateHawk nel 2024
API
ETG API v3 · REST · JSON
In PHPTRAVELS
Connettore pronto nel modulo alloggi

Il flusso di prenotazione ETG API v3

Come si svolge una prenotazione RateHawk, fase per fase

Ogni prenotazione RateHawk attraversa le stesse cinque fasi. Per ciascuna trovi le chiamate ETG API coinvolte e ciò che PHPTRAVELS fa per te.

  1. 01

    Ricerca

    Chiamate ETG API

    Ricerca per regione · per coordinate geografiche · per ID hotel

    PHPTRAVELS

    Cerca per città, area della mappa o elenco di hotel, con date, ospiti e residenza del viaggiatore, e mostra tariffe nette live con il tuo ricarico.

  2. 02

    Pagina hotel

    Chiamate ETG API

    Retrieve hotelpage

    PHPTRAVELS

    Carica tutte le camere e le tariffe dell'hotel scelto: trattamento, tasse, condizioni di cancellazione e tipo di pagamento.

  3. 03

    Pre-prenotazione

    Chiamate ETG API

    Prebook rate · Retrieve rate info

    PHPTRAVELS

    Verifica subito prima del pagamento che la tariffa scelta sia ancora disponibile a quel prezzo e blocca il checkout se è cambiata.

  4. 04

    Prenotazione

    Chiamate ETG API

    Creare, avviare e verificare il processo di prenotazione

    PHPTRAVELS

    Crea la prenotazione, invia i dati degli ospiti, segue lo stato fino alla conferma e salva l'ID ordine RateHawk.

  5. 05

    Dopo la prenotazione

    Chiamate ETG API

    Retrieve bookings · Cancel booking · Webhook di stato

    PHPTRAVELS

    Invia il voucher, mostra la prenotazione nel pannello e nell'account del cliente e gestisce le cancellazioni secondo le condizioni della tariffa.

Dati statici

Importa una volta il database hotel di RateHawk e mantienilo aggiornato

I risultati di ricerca contengono solo tariffe. Nomi, indirizzi, foto, servizi e descrizioni arrivano dai dati statici di ETG, che PHPTRAVELS importa nelle tue pagine hotel.

  • Dump delle regioni

    Paesi, città e zone, così i viaggiatori possono cercare per destinazione.

  • Dump degli hotel

    Il file completo dei contenuti hotel: nomi, indirizzi, coordinate, foto, servizi e descrizioni.

  • Dump incrementale

    Solo ciò che è cambiato dall'ultimo import, così il catalogo resta aggiornato senza un ricaricamento completo.

  • Dump delle recensioni

    Punteggi e testi delle recensioni degli ospiti da mostrare nelle pagine hotel, se il tuo accordo li prevede.

Import contenuti hotel
  • Dump delle regioni100%
  • Dump degli hotel100%
  • Dump incrementale64%
  • Dump delle recensioni30%

Schermata di esempio. I numeri dipendono dal tuo account e dalle tue lingue.

Oltre ai file dump, ETG offre anche una Content API per ottenere i dati degli hotel on demand.

API key e sandbox

Come funziona l'autenticazione dell'API RateHawk

La ETG API usa l'autenticazione HTTP Basic. Il tuo key ID è il nome utente e la tua API key è la password, inviati via HTTPS a ogni richiesta.

Una richiesta di ricerca in sandbox (esempio)
 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
Due host
Sandbox: api-sandbox.ratehawk.com. Test e produzione: api.ratehawk.com. I vecchi host worldota.net sono deprecati.
L'hotel di test è reale
Le chiavi di test possono prenotare solo l'hotel di test con hid 8473727, e quella prenotazione è reale, con una reale responsabilità finanziaria. Cancellala subito dopo il test.
Le chiavi restano sul server
PHPTRAVELS conserva key ID e API key nella configurazione del server, mai nel browser o in un'app.
La residenza conta
Le tariffe dipendono dalla residenza del viaggiatore, per questo il connettore la invia a ogni ricerca.

Configurazione in PHPTRAVELS

Configura il connettore RateHawk in quattro passaggi

Nessun codice da scrivere: il connettore si configura nel pannello di amministrazione.

  1. 01Inserisci le chiavi APIIncolla key ID e API key ricevuti da RateHawk, prima per la sandbox e poi per la produzione.
  2. 02Importa il database hotelCarica i dump delle regioni e degli hotel, poi pianifica gli aggiornamenti incrementali.
  3. 03Imposta ricarico e valutaRicarichi percentuali o fissi, per canale, gruppo di agenti o destinazione, nelle valute in cui vendi.
  4. 04Prova e vai in produzioneEsegui la prenotazione e la cancellazione di test, supera la certificazione, poi passa alle chiavi di produzione.
Fornitori › RateHawkRateHawk

Ambiente

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

Key ID4127
API key••••••••••••••••
Ricarico12% sulle tariffe nette
ValutaUSD · EUR · GBP
Residenza predefinitaGB

Schermata impostazioni di esempio.

Certificazione

Dall'accordo all'accesso in produzione

RateHawk apre la produzione solo dopo la firma dell'accordo e il superamento della certificazione da parte della tua integrazione.

  1. 1

    Firma l'accordo API

    Tu

    Contatta RateHawk come azienda di viaggi e firma l'accordo API per i tuoi mercati.

  2. 2

    Ricevi le chiavi sandbox

    RateHawk

    RateHawk rilascia un key ID e una API key per la sandbox.

  3. 3

    Collega e importa

    PHPTRAVELS

    Le chiavi vengono inserite in PHPTRAVELS, i dati statici vengono importati e i ricarichi impostati.

  4. 4

    Supera la certificazione

    RateHawk

    RateHawk verifica l'integrazione, inclusi i flussi di prenotazione, stato e cancellazione.

  5. 5

    Accesso in produzione

    Tu

    Le chiavi di produzione vengono inserite nel pannello e partono le prenotazioni reali.

Portale, API o motore

Tre modi per vendere gli hotel RateHawk

Gli agenti possono già prenotare oggi sul sito di RateHawk. L'API, dentro il tuo motore di prenotazione, è ciò che porta gli hotel RateHawk sotto il tuo marchio.

  • Sito RateHawk

    Chi prenota
    I tuoi agenti, una prenotazione alla volta
    Di chi è il marchio
    RateHawk
    Cosa serve
    Registrarsi come agente e accedere

  • Sviluppo API in proprio

    Chi prenota
    I tuoi clienti e agenti, online
    Di chi è il marchio
    Il tuo
    Cosa serve
    Mesi di sviluppo e certificazione

  • PHPTRAVELS con RateHawk

    Chi prenota
    I tuoi clienti e agenti, online
    Di chi è il marchio
    Il tuo
    Cosa serve
    Configurazione, import dei contenuti e certificazione

Multi-fornitore

RateHawk accanto agli altri tuoi fornitori alberghieri

RateHawk è uno dei fornitori del modulo alloggi. La stessa ricerca può includere le altre tue API alberghiere e i tuoi contratti diretti, con ricarichi e instradamento per fornitore.

  • Agoda
  • Amadeus
  • Booking.com
  • Hotelbeds
  • Hotelston
  • RateHawk
  • Stuba
  • TBO Holidays
  • Travelport
  • Wanderbeds
Vedi i prezziProva la demo hotel

Leggi la guida per agenti

FAQ

Domande sull'integrazione API RateHawk

Cosa chiedono le agenzie prima di collegare RateHawk.

Contatta il team vendite

RateHawk non pubblica alcun costo per l'accesso all'API. Firmi un accordo API e vendi i suoi hotel a tariffe nette con il tuo ricarico. I tuoi costi sono il software di prenotazione, l'hosting e i pagamenti.

Contatta RateHawk come azienda di viaggi e firma l'accordo API. RateHawk rilascia quindi un key ID e una API key per la sandbox, e le chiavi di produzione dopo la certificazione.

La documentazione della ETG API è online su docs.emergingtravel.com, con la B2B API, la Content API e le guide su sandbox e certificazione. Non esiste un PDF separato da scaricare: la documentazione online è la versione aggiornata.

La ETG API è l'API di Emerging Travel Group, l'azienda dietro RateHawk. Integrazione API RateHawk e integrazione ETG API indicano la stessa cosa; la versione attuale è la v3.

PHPTRAVELS è una licenza una tantum a partire da 2499 USD con il codice sorgente completo, e il connettore RateHawk è incluso nel modulo alloggi. Le condizioni commerciali con RateHawk le concordi direttamente con RateHawk.

Sì, su api-sandbox.ratehawk.com. Attenzione: le chiavi di test possono prenotare solo l'hotel di test con hid 8473727, e quella prenotazione è reale, quindi cancellala subito dopo il test.

Gli agenti si registrano e accedono su ratehawk.com per prenotare nel portale. L'accesso all'API è separato: usa key ID e API key del tuo accordo, non il login del portale.

Il connettore esiste già, quindi il tempo va nell'accordo, nell'inserimento delle chiavi, nell'import dei contenuti hotel e nella certificazione di RateHawk, non nello sviluppo.

Sì. Lo stesso connettore serve il tuo sito B2C e il tuo portale agenti B2B, con ricarichi separati per canale e gruppo di agenti.

Ogni tariffa ha le sue condizioni di cancellazione, mostrate prima del pagamento. Le cancellazioni si eseguono dal pannello o dall'account del cliente tramite la chiamata di cancellazione della prenotazione, secondo tali condizioni.

Continua a esplorare

Altro sulla piattaforma