API hotel B2B per operatori del turismo

Cosa copre l’API

Il flusso hotel segue l’ordine in cui avviene davvero una prenotazione: cercare una destinazione, richiedere la disponibilità in tempo reale per un hotel, fare il checkout dell’opzione scelta (il prezzo viene rivalidato con il fornitore in questo passaggio), pagare, confermare e, in seguito, elencare, consultare o cancellare le prenotazioni. I prezzi restituiti includono già il markup configurato per la vostra agenzia.

La stessa chiave API vale anche per i transfer privati, compreso il servizio con autista a ore, e per il noleggio auto. Integrate un solo schema di autenticazione, un solo formato degli errori e un solo registro di utilizzo per tutti e tre i prodotti.

BASE="https://api.trekko.co/core"
AUTH="Authorization: ApiKey trk_test_xxxxxxxx:your_secret_here"

# 1) Search for the city
curl -sS "${BASE}/accommodation/search?query=Barcelona" -H "${AUTH}"

# 2) Live availability (prices already include your markup)
curl -sS -X POST "${BASE}/accommodations/get_accommodation_availability" \
  -H "${AUTH}" -H "Content-Type: application/json" \
  -d '{
        "accommodation_id": 1376114,
        "start_date": "2027-04-12",
        "end_date": "2027-04-15",
        "guests": [ { "id": 1, "age": 34 }, { "id": 2, "age": 30 } ],
        "guests_room_distribution": [ { "guest_ids": [1, 2] } ],
        "nationality": "ES",
        "currency_code": "EUR"
      }'

Pensata per il traffico di produzione

Le API di prenotazione falliscono in modi costosi: un timeout durante la conferma può creare una prenotazione duplicata. La chiamata di conferma accetta un header Idempotency-Key, per cui un nuovo tentativo con la stessa chiave restituisce la risposta originale invece di prenotare due volte.

I limiti di richieste si applicano per chiave API e non per indirizzo IP, e quelli di ogni agenzia sono indipendenti, quindi il traffico di un altro partner non rallenta mai il vostro. Gli errori condividono un formato comune e gli errori di autenticazione seguono la consueta distinzione tra credenziali sconosciute e credenziali valide senza permesso.

Webhook e rebooking automatico

Le prenotazioni effettuate via API sono idonee al rebooking automatico di Trekko: finché la cancellazione gratuita è ancora aperta, la prenotazione viene controllata ogni giorno per cercare una tariffa più bassa sullo stesso soggiorno. Quando avviene un rebooking, la vostra prenotazione mantiene lo stesso identificativo stabile e il vostro sistema riceve un webhook firmato booking.rebooked con prezzo precedente, nuovo prezzo e risparmio.

I webhook sono firmati con HMAC, così potete verificare che provengano da Trekko, e la consegna è almeno una volta con tentativi automatici; ogni evento porta un identificativo su cui deduplicare. Tramite API potete anche escludere dal rebooking una singola prenotazione.

Prima la sandbox, poi la produzione quando siete finanziati

Iscrivetevi alla sandbox con la vostra email, confermate il codice che vi inviamo e ricevete subito le credenziali di test. La sandbox esegue l’intero ciclo di prenotazione su un catalogo di prova fisso, non chiama mai un fornitore reale e non muove mai denaro, e include un simulatore di rebooking per testare il flusso dei webhook su richiesta.

Ricaricare il conto non richiede un’integrazione di pagamento separata. Finanziate il vostro account Trekko fino al deposito minimo con ricarica da carta, bonifico o una linea di credito concordata, richiedete l’accesso alla produzione e, dopo l’approvazione del team Trekko, lo attivate per ricevere la chiave live. Per passare dalla sandbox alla produzione si cambiano chiave e base URL, si aggiunge il passaggio di pagamento, si invia la conferma completa e si gestiscono gli errori che la sandbox non produce.

Una checklist di integrazione

Memorizzate l’identificativo di prenotazione stabile restituito alla conferma, non il numero di conferma del fornitore, che può cambiare dopo un rebooking. Inviate un Idempotency-Key a ogni conferma. Verificate la firma di ogni webhook prima di agire e deduplicate sull’identificativo dell’evento. Mostrate ai vostri utenti la scadenza di cancellazione restituita con ogni offerta.

Chi integra l’API di Trekko

Agenzie di viaggio online che aggiungono gli hotel ai propri siti, tour operator che alimentano un motore di dynamic packaging, strumenti di prenotazione aziendali che richiedono soggiorni e trasporti a terra, e startup del turismo che vogliono inventario senza negoziare uno per uno i contratti con i fornitori.

Domande frequenti