L'API Vrbo : comment fonctionne l'accès, et ce que tu peux construire aujourd'hui

Ça vaut la peine de dissiper la confusion, parce que c'est de là que vient l'essentiel des mauvaises informations. Vrbo fait partie d'Expedia Group, et Expedia Group gère plusieurs surfaces développeur qui ne sont pas la même chose. Celle qui compte si tu gères des locations saisonnières ou que tu crées du logiciel pour elles, c'est la connectivité propre à Vrbo : l'intégration qu'utilise le logiciel d'un gestionnaire pour garder tarifs, disponibilités et réservations alignés avec Vrbo. Une page qui te dit d'obtenir une clé d'API Vrbo en dix minutes décrit autre chose.

• Annonces : détails de l'annonce, tarifs, configuration du logement et disponibilités.
• Réservation en ligne : générer des devis, vérifier les disponibilités, réserver, mettre à jour les dossiers de réservation.
• Avis : partager les avis sur le bien pour les afficher sur Vrbo.
• Demandes : récupérer les demandes de location envoyées via Vrbo.

Expedia Group décrit le résultat simplement : avec la connectivité API, les tarifs, les disponibilités et les réservations se mettent à jour dynamiquement de ton logiciel vers Vrbo, et les prix, les calendriers et les politiques d'annulation se pilotent depuis ton logiciel plutôt que depuis l'extranet Vrbo. Le sens compte : la connectivité Vrbo est conçue pour que ton système soit la source de vérité et envoie les données, un modèle mental différent de l'OAuth demande-consentement d'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.

Les endpoints de canal répondent à “qu'a Vrbo ?”. Pour tout ce que tu mettrais devant une personne — le voyageur, le versement, la politique sous laquelle le séjour a été réservé —, lis plutôt la surface multicanale, où une réservation Vrbo arrive sous la même forme qu'une réservation 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

• Import.Rien n'est importé tant que l'hôte n'a pas rattaché ses logements. Ensuite, les prochaines réservations et les messages des 30 derniers jours arrivent d'abord, et le reste de l'historique suit en arrière-plan.
• Pagination. Les deux endpoints sont paginés par curseur ; ?offset= est accepté pour une pagination peu profonde et ne se combine pas avec cursor.
• Annonces inactives. Une annonce désactivée continue de se synchroniser mais sort de ces lectures, comptes et curseurs compris. Retrouve-les avec GET /v1/listings?status=inactive.
• Créer des réservations. POST /v1/reservations est limité à direct, website et owner. Un séjour Vrbo appartient au canal et arrive par synchronisation ; le créer localement ne ferait que se battre avec la synchronisation suivante.

Pour aller plus loin sur les deux autres : le guide de l'API Airbnb et le guide de l'API Booking.com.

Ça vaut la peine d'être concret sur l'écart, parce que “on utilisera iCal, point” est une décision que les équipes regrettent deux mois plus tard. Un flux de calendrier te donne une plage de dates et une étiquette. Il ne te dit pas qui a réservé, combien il a payé, ce qu'il a demandé dans le fil de messages, quelle politique s'applique s'il annule, ni si le prix de l'annonce est toujours celui que tu voulais facturer. Tout ça est derrière la connectivité.

• Une messagerie unifiée ou un assistant IA qui répond aux voyageurs et aux demandes Vrbo à côté d'Airbnb et de Booking.com, sans que l'hôte change de PMS.
• Un flux unique de réservations auquel il ne manque aucun canal : les réservations Vrbo arrivent sous la même forme normalisée que celles d’Airbnb et de Booking.com.
• Des rapports d'occupation, d'ADR et de revenus où la part Vrbo est vraiment comptée plutôt qu'estimée.
• Un CRM voyageurs qui reconnaît le même voyageur sur tous les canaux au lieu de créer un troisième profil.
• La gestion des avis Vrbo, Airbnb et Booking.com depuis un seul endroit.
• Des relevés propriétaires qui tombent juste, parce que les séjours Vrbo sont dans le même registre que tout le reste.

Commence par la doc, ou lis comment le même raisonnement s'applique aux deux autres grands canaux dans les guides Airbnb et Booking.com. Si tu es une plateforme SaaS qui compte mettre ça devant ses propres clients, le volet commercial est dans Repull pour les plateformes, avec la version technique détaillée dans les questions-réponses pour plateformes SaaS.