API Vrbo: jak działa dostęp i co możesz zbudować już dziś

Warto nazwać to zamieszanie, bo to z niego bierze się większość błędnych informacji. Vrbo należy do Expedia Group, a Expedia Group prowadzi kilka interfejsów dla deweloperów, które nie są tym samym. Jeśli zarządzasz najmem krótkoterminowym albo tworzysz dla niego oprogramowanie, liczy się własna łączność Vrbo – integracja, dzięki której oprogramowanie zarządcy utrzymuje stawki, dostępność i rezerwacje w zgodzie z Vrbo. Strona, która obiecuje klucz API Vrbo w dziesięć minut, opisuje coś innego.

• Oferty – szczegóły oferty, stawki najmu, konfiguracja obiektu i dostępność.
• Rezerwacje online – tworzenie wycen, sprawdzanie dostępności, rezerwowanie, aktualizacja danych rezerwacji.
• Opinie – udostępnianie opinii o obiekcie do wyświetlenia w Vrbo.
• Zapytania – pobieranie zapytań o najem złożonych przez Vrbo.

Expedia Group opisuje efekt wprost: dzięki łączności przez API stawki, dostępność i rezerwacje aktualizują się dynamicznie z twojego oprogramowania do Vrbo, a ceny, kalendarze i zasady anulowania są sterowane z twojego oprogramowania, a nie z extranetu Vrbo. Kierunek ma znaczenie – łączność Vrbo jest zbudowana tak, by twój system był źródłem prawdy i wysyłał dane, co jest innym modelem myślenia niż OAuth Airbnb oparty na prośbie i zgodzie.

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.

Endpointy kanału odpowiadają na pytanie „co ma Vrbo”. Do wszystkiego, co pokazałbyś człowiekowi – gościa, wypłatę, zasady, na jakich zarezerwowano pobyt – użyj interfejsu międzykanałowego, gdzie rezerwacja z Vrbo ma ten sam kształt co rezerwacja z 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. Nic nie jest importowane, dopóki gospodarz nie przypisze swoich lokali. Potem najpierw trafiają nadchodzące rezerwacje i wiadomości z ostatnich 30 dni, a reszta historii dochodzi w tle.
• Stronicowanie. Oba endpointy są stronicowane kursorem; ?offset= jest akceptowany przy płytkim stronicowaniu i wyklucza się z cursor.
• Nieaktywne oferty. Wyłączona oferta dalej się synchronizuje, ale znika z tych odczytów, łącznie z licznikami i kursorami. Znajdziesz je przez GET /v1/listings?status=inactive.
• Tworzenie rezerwacji. POST /v1/reservations jest ograniczone do direct, website i owner. Pobyt z Vrbo należy do kanału i przychodzi przez synchronizację; utworzenie go lokalnie tylko kłóciłoby się z następną synchronizacją.

Więcej o pozostałych dwóch: przewodnik po API Airbnb i przewodnik po API Booking.com.

Warto być konkretnym co do tej luki, bo „po prostu użyjemy iCal” to decyzja, której zespoły żałują po dwóch miesiącach. Kanał kalendarza daje ci zakres dat i etykietę. Nie mówi, kto zarezerwował, ile zapłacił, o co pytał w wątku, jakie zasady obowiązują, jeśli anuluje, ani czy cena w ofercie to wciąż ta, którą chciałeś pobrać. Wszystko to jest za łącznością.

• Wspólną skrzynkę wiadomości lub asystenta AI, który odpowiada gościom i na zapytania z Vrbo obok Airbnb i Booking.com – bez zmiany PMS przez gospodarza.
• Jeden strumień rezerwacji, w którym nie brakuje żadnego kanału – rezerwacje z Vrbo mają ten sam znormalizowany kształt co z Airbnb i Booking.com.
• Raporty obłożenia, ADR i przychodów, w których udział Vrbo jest naprawdę liczony, a nie szacowany.
• CRM gości, który rozpoznaje tego samego gościa we wszystkich kanałach, zamiast tworzyć trzeci profil.
• Zarządzanie opiniami z Vrbo, Airbnb i Booking.com w jednym miejscu.
• Rozliczenia dla właścicieli, które się zgadzają, bo pobyty z Vrbo są w tej samej księdze co cała reszta.

Zacznij od dokumentacji albo przeczytaj, jak to samo rozumowanie dotyczy dwóch pozostałych dużych kanałów w przewodnikach po Airbnb i Booking.com. Jeśli jesteś platformą SaaS, która chce dać to swoim klientom, stronę biznesową opisuje Repull dla platform, a pogłębioną wersję techniczną pytania i odpowiedzi dla platform SaaS.