Booking-API for hotell og fly: én reise, to bookinger

Oppgaven lyder: "legg hotell til i flyflyten, én kasse, én totalsum". Det er et rimelig ønske fra en produktsjef, og det høres ut som en dags arbeid, for dere har allerede flysøk og dere har allerede en betalingsside. Tre uker senere krangler teamet om hva som skal skje når flyselskapet bekrefter og hotellet ikke gjør det. Et booking-API for hotell og fly er ikke én integrasjon med to typer resultat. Det er to integrasjoner som deler en handlekurv.
Jo før koden innrømmer det, jo mindre av den må skrives om. Det som følger er delen integrasjonsguidene hopper over: hvordan de to halvdelene skiller seg, hvilken du forplikter først, og hva en reise må være i datamodellen din.
De to halvdelene oppfører seg ikke likt
Begge kommer tilbake som JSON med en pris og en referanse, så på linjen ser de like ut. De er ikke like i hva de lover deg når du først har referansen.
| Spørsmål | Fly | Hotell |
|---|---|---|
| Hva du sitter med etter booking | En reservasjon (PNR) som ennå ikke er en billett | En bekreftelse som vanligvis allerede er det du solgte |
| Hvor lenge prisen gjelder | Til prisen beregnes på nytt ved booking, og den kan avvike fra søket | Til raten utløper, og en rate kan endre seg mellom tilgjengelighet og booking |
| Hva som bekrefter den | Utstedelse av billett, ofte mot en tidsfrist | Leverandørens bekreftelse, noen ganger umiddelbart, noen ganger ventende |
| Hvordan den angres | En void hvis det fanges tidlig, ellers refusjon etter prisreglene, ofte med gebyr | En kansellering etter ratens egne vilkår, gratis frem til en frist på mange rater |
| Hva som endrer tallet sent | Pris, avgifter, noen ganger prisens valuta | Skatter og gebyrer betalt på stedet, kosttype, rommet som faktisk tildeles |
Du kan være uenig i en rad, for leverandører er forskjellige, men ikke i formen: den ene halvdelen har et utstedelsessteg og den andre har et kanselleringsvindu, og de faller ikke sammen i tid. Flysiden av sekvensen dekket vi i integrasjon av booking-API for fly, og problemet med trege leverandører på hotellsiden i klientdesign for hotelltilgjengelighets-API. Denne teksten begynner der de slutter, i skjøten.
Hvilken booker du først?
Ingen forteller deg at dette er en designbeslutning, og det er den som avgjør hva en feil koster.
Si at en kunde kjøper fly og hotell for de samme datoene. Du sender den ene bookingen og så den andre. Tre ting kan skje: begge lykkes, eller én feiler, eller én feiler etter at den andre har lykkes. Det første er en god dag. De to andre bestemmer supportkøen din.
Utsteder du flybilletten først og hotellet så avslår, har du en kunde med sete til en by og uten rom, som allerede er belastet, og en refusjon på en billett som har gebyr. Booker du hotellet først og flyet så feiler, sitter du med et rom du ofte kan kansellere gratis, så reparasjonen er billig. Den motsatte risikoen er også ekte, for en hotellrate som ikke kan kanselleres er det verste å sitte med, så les kanselleringsvilkårene på raten før du lar den gå først.
Dette er en tommelfingerregel, ikke en lov, og poenget er at du velger rekkefølgen med vilje. Forplikt halvdelen som er lettest å angre før halvdelen som er vanskeligere, sjekk prisen på begge rett før noen av dem forplikter, og skriv ned hva du gjør i hvert av de tre utfallene. Kodegjennomgang spør sjelden. Kundene finner det alltid ut.
Én reise, to bookinger
Formen som holder er en reisepost som eier to bookinger, hver med sin egen referanse, sin egen status og sine egne vilkår. Kunden ser én totalsum. Databasen ser to rader, og totalsummen er en sum du regner ut, ikke noe som finnes hos leverandøren.
Hold de to statusene adskilt. "Bekreftet" for hotellet og "utstedt" for flyet er ikke samme tilstand, og en enkelt statuskolonne som flater dem ut vil før eller senere si "booket" om en halvt booket reise.
Hold også de to settene med endringsvilkår adskilt, og vis dem. En vist totalsum skjuler at det å flytte datoene er en gratis endring på den ene halvdelen og et gebyr på den andre. Viser frontenden "endre datoer" som én knapp, bestem hva den gjør når bare én halvdel kan flyttes, før en kunde finner det ut for deg. Det samme gjelder påslag: legger du ditt per tjeneste, slik de fleste selgere gjør, er reisens totalsum to påslag, og en refusjon på én halvdel må vite hvilket påslag den returnerer. Penger er der en sammensatt reise blir dyr, fordi linjene gjøres opp på ulike tidslinjer, og en refusjon på et fly kommer ikke når hotellets kansellering gjør det.
Hvor denne plattformen står
Rett ut: plattformen tilbyr API-er for fly og hotell, og tilgang begynner som en samtale, ikke som en nøkkel du henter selv. Tjenester slås på per tenant, så en tenant som selger hotell og ikke turer, bærer ikke tur-flaten. Ingenting her lover ett enkelt kall som booker begge halvdeler atomisk, og du bør ikke designe som om det gjorde det. Behandle dem som de to bookingene de er, under en reise du eier.
Vil du se de faktiske kallene og vilkårene før du bygger rundt dem, start fra siden om reise-API-er og ta med rekkefølgen du har tenkt å booke i. Er du fortsatt usikker på hva gratis tilgang gir deg, går gratis booking-API for hotell gjennom de ulike typene gratis.
Hva det koster å ta feil
Den dyre versjonen er den stille. En kunde har billett til en by og rommet er borte, og det første du hører er en melding om natten, fra en flyplass. Billigere, men fortsatt ekte: en kasse som viser én betryggende totalsum og så, etter en priskontroll, et nytt tall kunden ikke godtok; en refusjon som returnerer flyet og glemmer hotellet; og en status som sier "booket" mens leverandøren sier noe annet.
Ingenting av dette trenger en smart løsning. Det trenger at reisen er et ekte objekt, at rekkefølgen er en beslutning noen skrev ned, og en ny sjekk av begge prisene i siste øyeblikk før noen av dem forplikter. Bygg det én gang, så kan kassen se like enkel ut som oppgaven ba om.