L'API di Vrbo: come funziona l'accesso e cosa puoi costruire oggi

Vale la pena chiarire la confusione, perché è da lì che arriva gran parte delle informazioni sbagliate. Vrbo sta dentro Expedia Group, ed Expedia Group gestisce diverse superfici per sviluppatori che non sono la stessa cosa. Quella che conta se gestisci affitti brevi o crei software per loro è la connettività di Vrbo: l'integrazione che il software di un property manager usa per tenere tariffe, disponibilità e prenotazioni allineate con Vrbo. Una pagina che ti dice di ottenere una chiave API di Vrbo in dieci minuti sta descrivendo un'altra cosa.

• Annunci: dettagli dell'annuncio, tariffe, configurazione dell'alloggio e disponibilità.
• Prenotazione online: generare preventivi, verificare la disponibilità, prenotare, aggiornare i record delle prenotazioni.
• Recensioni: condividere le recensioni della proprietà da mostrare su Vrbo.
• Richieste: recuperare le richieste di affitto inviate tramite Vrbo.

Expedia Group descrive il risultato in modo chiaro: con la connettività via API, tariffe, disponibilità e prenotazioni si aggiornano dinamicamente dal tuo software a Vrbo, e prezzi, calendari e politiche di cancellazione si controllano dal tuo software invece che dall'extranet di Vrbo. La direzione conta: la connettività di Vrbo è costruita perché il tuo sistema sia la fonte di verità e invii i dati, un modello mentale diverso dall'OAuth di richiesta e consenso di Airbnb.

curl -X POST https://api.repull.dev/v1/connect \
  -H 'Authorization: Bearer sk_live_...' \
  -H 'Content-Type: application/json' \
  -d '{
    "redirectUrl": "https://yourapp.com/connected",
    "allowedProviders": ["vrbo-login"],
    "accessType": "messaging"
  }'

# Send the host to the returned url. They sign in with their Vrbo
# account and map their units; the import starts when they confirm.

curl 'https://api.repull.dev/v1/channels/vrbo/reservations?limit=50' \
  -H 'Authorization: Bearer sk_live_...'

# Page with the cursor from pagination.nextCursor.
# ?offset= is accepted as a first-class alias for shallow paging.

Gli endpoint di canale rispondono a “cosa ha Vrbo”. Per tutto ciò che metteresti davanti a una persona — l'ospite, il pagamento, la politica con cui è stato prenotato il soggiorno — leggi invece la superficie trasversale, dove una prenotazione Vrbo arriva nella stessa forma di una Airbnb.

# The same reservation, with everything on it, from the
# cross-channel read — guest, price breakdown, policy code.
curl 'https://api.repull.dev/v1/reservations?platform=vrbo&limit=50' \
  -H 'Authorization: Bearer sk_live_...'

# Conversations and reviews take the same filter:
#   /v1/conversations?platform=vrbo
#   /v1/reviews?platform=vrbo
# Properties filters on the channel it is published to:
#   /v1/properties?channel=vrbo

• Importazione.Non viene importato nulla finché l'host non associa le sue unità. Poi arrivano prima le prossime prenotazioni e i messaggi degli ultimi 30 giorni, e il resto dello storico segue in background.
• Paginazione. Entrambi gli endpoint sono paginati a cursore; ?offset= è accettato per la paginazione leggera ed è alternativo a cursor.
• Annunci inattivi. Un annuncio disattivato continua a sincronizzarsi ma esce da queste letture, conteggi e cursori compresi. Trovali con GET /v1/listings?status=inactive.
• Creare prenotazioni. POST /v1/reservations è limitato a direct, website e owner. Un soggiorno Vrbo appartiene al canale e arriva tramite sincronizzazione; crearlo in locale andrebbe solo in conflitto con la sincronizzazione successiva.

Approfondimento sugli altri due: la guida all'API di Airbnb e la guida all'API di Booking.com.

Vale la pena essere concreti sulla differenza, perché “useremo iCal e basta” è una decisione di cui i team si pentono dopo due mesi. Un feed del calendario ti dà un intervallo di date e un'etichetta. Non ti dice chi ha prenotato, quanto ha pagato, cosa ha chiesto nella conversazione, quale politica si applica se cancella o se il prezzo sull'annuncio è ancora quello che volevi far pagare. Tutto questo sta dietro la connettività.

• Un'inbox unificata o un assistente IA che risponde a ospiti e richieste Vrbo accanto ad Airbnb e Booking.com, senza che l'host cambi PMS.
• Un unico flusso di prenotazioni a cui non manca un canale: le prenotazioni Vrbo arrivano nella stessa forma normalizzata di quelle Airbnb e Booking.com.
• Report di occupazione, ADR e ricavi in cui la quota Vrbo viene contata davvero invece che stimata.
• Un CRM degli ospiti che riconosce lo stesso ospite su tutti i canali invece di creare un terzo profilo.
• Gestione delle recensioni di Vrbo, Airbnb e Booking.com da un unico posto.
• Rendiconti ai proprietari che tornano, perché i soggiorni Vrbo sono nello stesso registro di tutto il resto.

Comincia dalla documentazione, oppure leggi come lo stesso ragionamento si applica agli altri due grandi canali nelle guide di Airbnb e Booking.com. Se sei una piattaforma SaaS che vuole mettere tutto questo davanti ai propri clienti, la parte commerciale è in Repull per le piattaforme, con la versione tecnica più approfondita nelle domande e risposte per piattaforme SaaS.