API di prenotazione hotel gratuita: cosa dà davvero

È giovedì pomeriggio e la demo è lunedì. Hai trovato un'API di prenotazione hotel gratuita, ti sei registrato con un indirizzo email e in cinque minuti avevi una chiave. L'endpoint di ricerca restituisce hotel con foto, stelle e prezzo a notte. In serata la pagina dei risultati sembra quella giusta. Venerdì colleghi la chiamata di prenotazione e risponde con un errore che non riesci a decifrare, perché ciò a cui ti sei iscritto non è mai stato in grado di fare una prenotazione.
Nessuno ti ha mentito. In questo mercato la parola "gratis" è semplicemente appiccicata a quattro prodotti diversi, e le pagine di registrazione non dicono quale hai in mano.
Quattro cose che "gratis" può voler dire
Vale la pena tenere questa tabella accanto alla tastiera. Se il tuo fornitore si comporta diversamente su una riga, contestala: è anche questo un risultato utile.
| Che cos'è l'offerta gratuita | Cosa ottieni | Cosa puoi costruire | Cosa non può fare |
|---|---|---|---|
| Contenuti statici o dati di directory | Nomi degli hotel, indirizzi, foto, servizi, descrizioni | Una guida agli hotel, una mappa, una pagina di destinazione | Mostrare un prezzo che puoi onorare, o una camera davvero libera nelle tue date |
| Ricerca affiliata con reindirizzamento | Hotel e prezzi, più un link verso il checkout del venditore | Una pagina di confronto che manda il traffico altrove | Tenere dalla tua parte il cliente, il pagamento o il record della prenotazione |
| Sandbox con tariffe di test | Le chiamate complete di ricerca, prezzo, prenotazione e cancellazione, con inventario inventato | Un'integrazione funzionante e una demo che si comporta come la produzione | Creare una prenotazione che un hotel vero onorerà |
| Tariffe live prenotabili | Camere vere a prezzi net o di vendita reali, confermate dal fornitore | Un negozio che incassa soldi per le camere | Essere gratis per chi firma il contratto |
Le prime tre sono gratuite perché al fornitore non costa quasi nulla regalarle. La quarta non lo è, perché qualcuno si sta facendo carico di qualcosa di reale.
Perché una tariffa prenotabile arriva sempre con un contratto
Quando il tuo cliente paga una camera, parte una catena di obblighi. Un fornitore detiene il contratto con l'hotel. Quel fornitore ha promesso all'hotel che la camera sarà pagata, e ha promesso a te che la camera esiste. Se l'ospite cancella dopo la scadenza della cancellazione gratuita, qualcuno deve una notte all'hotel. Se la tariffa era sbagliata, qualcuno assorbe la differenza. Se la carta era rubata, qualcuno si ritrova con il chargeback.
Tutto questo deve ricadere su una parte con un nome. Una chiave API che chiunque può generare con un indirizzo email non può reggerlo, ed è per questo che l'accesso prenotabile arriva con un accordo, una modalità di regolamento e spesso un limite di credito. Il prezzo che paghi per la chiave "gratuita" è che il fornitore non deve preoccuparsi di cosa ci fai.
Niente di tutto ciò è una critica ai piani gratuiti. Un feed di contenuti è esattamente ciò che serve per una guida di destinazione. È sbagliato solo quando viene scambiato per ciò che ti serve per accettare una prenotazione.
Se stai anche decidendo quanti fornitori ti servono dietro quello che scegli, ne abbiamo parlato in quanti fornitori di API alberghiere servono; la versione voli della stessa confusione è in i tre tipi di API voli gratuita.
C'è un'altra trappola dentro la prima riga. Contenuti statici e tariffe live sono due feed con vite diverse: la descrizione di un hotel può restare nella tua cache per settimane, una tariffa per stanotte non può restarci per minuti. Un feed di contenuti gratuito che mostra anche un prezzo sta citando un numero di cui non risponderà, e una pagina costruita sopra mostrerà allegramente una camera venduta ieri.
Cosa testare in sandbox prima di firmare qualsiasi contratto
La sandbox è la cosa gratuita più utile della tabella, quindi usala a fondo. Una buona sandbox ti fa fare ogni passo di una prenotazione vera, con inventario finto ma con la forma di quello reale.
- Cerca con bambini e più camere. L'occupazione è il punto in cui le integrazioni semplici si rompono per prime. Chiedi due camere con ospiti diversi e verifica se la risposta le tiene separate.
- Controllo del prezzo prima di prenotare. Molti fornitori si aspettano una seconda chiamata che confermi che la tariffa è ancora valida. Se la sandbox non ha questo passaggio, chiedi se la produzione ce l'ha.
- Prenota, poi leggi cosa torna indietro. Una camera confermata, una richiesta in attesa e una camera on request sono tre esiti diversi, e la tua schermata deve dire quale.
- Cambia la tariffa tra ricerca e prenotazione. Le tariffe si muovono. Che aspetto ha l'errore, e il tuo codice riesce a mostrare al cliente il nuovo prezzo invece di una pagina bianca?
- Cancella dentro e fuori dalla finestra gratuita. La politica di cancellazione dovrebbe arrivare come dati strutturati con date e importi, non come un paragrafo da interpretare.
- Fallisci apposta. Invia una data sbagliata, un codice hotel sconosciuto, un token scaduto. Conta quante forme diverse di errore ricevi.
Se la sandbox non sa fare i passi quattro e cinque, hai un'API di contenuti con un URL dall'aria di prenotazione.
Quanto costa costruire sul tipo sbagliato
La versione costosa di questo errore non è la settimana persa. È la demo che va bene.
Mostri a un decisore una pagina di ricerca pulita, lui approva il budget, e solo allora il team scopre che la fonte dietro non può confermare una camera. Il codice non è tutto da buttare, ma il flusso di prenotazione, il pagamento, la gestione delle cancellazioni e il regolamento vanno costruiti contro un altro fornitore con nomi di campo diversi. La pagina di ricerca che hai mostrato restituirà allora hotel diversi, a prezzi diversi, in un ordine diverso. Chi ha approvato il budget se ne accorgerà.
L'abitudine più economica è fare una domanda prima di scrivere codice: "Questa chiave può creare una prenotazione che un hotel onorerà, e poi cancellarla?" Se la risposta è qualcosa di diverso da sì, sai quale delle quattro hai in mano.
Dove si colloca questa piattaforma
Dobbiamo essere chiari sulla nostra posizione quanto lo siamo stati sulle altre. La piattaforma espone API per voli e hotel, e l'accesso parte da una conversazione, non da una chiave self-service. È la quarta riga della tabella: dietro l'inventario prenotabile c'è qualcuno che deve sapere chi sta chiedendo. Se vuoi vedere come funziona per il tuo progetto, parti dalla pagina delle API di viaggio e raccontaci cosa stai costruendo.
Contenuti gratuiti, link affiliati e sandbox hanno tutti il loro posto, e quello giusto dipende da cosa intendi vendere. Scegli in base a cosa sa fare la chiave il giorno in cui un cliente paga.