Booking-API til hotel og fly: én rejse, to bookinger

Opgaven lyder: "tilføj hoteller til flyflowet, én checkout, ét total". Det er en rimelig anmodning fra en produktchef, og det lyder som en dags arbejde, for I har allerede flysøgning og allerede en betalingsside. Tre uger senere diskuterer teamet, hvad der skal ske, når flyselskabet bekræfter, og hotellet ikke gør. Et booking-API til hotel og fly er ikke én integration med to slags resultater. Det er to integrationer, der deler en kurv.
Jo før koden indrømmer det, jo mindre af den skal skrives om. Det følgende er den del, integrationsguiderne springer over: hvordan de to halvdele adskiller sig, hvilken I binder først, og hvad en rejse skal være i jeres datamodel.
De to halvdele opfører sig ikke ens
Begge kommer tilbage som JSON med en pris og en reference, så på ledningen ligner de hinanden. De ligner ikke hinanden i det, de lover, når I først har referencen.
| Spørgsmål | Fly | Hotel |
|---|---|---|
| Hvad I har efter bookingen | En reservation (PNR), der endnu ikke er en billet | En bekræftelse, der som regel allerede er det, I solgte |
| Hvor længe prisen holder | Indtil prisen beregnes igen ved booking, og den kan afvige fra søgningen | Indtil raten udløber, og en rate kan ændre sig mellem tilgængelighed og booking |
| Hvad der bekræfter den | Udstedelse af billetten, ofte mod en tidsfrist | Leverandørens bekræftelse, nogle gange med det samme, nogle gange afventende |
| Hvordan den fortrydes | En void, hvis I når det tidligt, ellers en refusion efter prisreglerne, ofte med gebyr | En afbestilling efter ratens egen politik, på mange rater gratis indtil en frist |
| Hvad der ændrer beløbet sent | Pris, skatter, nogle gange prisens valuta | Skatter og gebyrer betalt på stedet, forplejningen, det værelse der faktisk tildeles |
I kan være uenige i en række, for leverandører er forskellige, men ikke i formen: den ene halvdel har et udstedelsestrin og den anden et afbestillingsvindue, og de ligger ikke samme sted i tid. Flysiden af forløbet dækkede vi i integration af et flybooking-API og problemet med den langsomme leverandør på hotelsiden i klientdesign til et API for hoteltilgængelighed. Denne tekst begynder, hvor de slutter: i samlingen.
Hvilken booker I først?
Ingen fortæller jer, at det er en designbeslutning, og det er netop den, der afgør, hvad en fejl koster.
Lad os sige, at en kunde køber fly og hotel til de samme datoer. I sender den ene booking og så den anden. Tre ting kan ske: begge lykkes, én fejler, eller én fejler, efter at den anden allerede er lykkedes. Det første er en god dag. De to andre afgør jeres supportkø.
Udsteder I flyet først, og hotellet derefter afviser, har I en kunde med et sæde til en by og intet værelse, som allerede er trukket, og en refusion på en billet med gebyr. Booker I hotellet først, og flyet derefter fejler, holder I et værelse, som ofte kan afbestilles gratis, så reparationen er billig. Den omvendte risiko findes også, for en hotelrate, der ikke kan afbestilles, er det værste at sidde med, så læs ratens afbestillingsvilkår, før I lader den gå først.
Det er en tommelfingerregel, ikke en lov, og pointen er at vælge rækkefølgen med vilje. Bind den halvdel, der er lettest at fortryde, før den sværere, tjek prisen på begge lige før nogen af dem bindes, og skriv ned, hvad I gør i hvert af de tre udfald. Reviewere spørger sjældent. Kunder finder altid ud af det.
Én rejse, to bookinger
Den form, der holder, er en rejsepost, der ejer to bookinger, hver med sin egen reference, sin egen status og sine egne vilkår. Kunden ser ét total. Jeres database ser to rækker, og totalen er en sum, I beregner, ikke noget, der findes hos leverandøren.
Hold de to statusser adskilt. "Bekræftet" for hotellet og "udstedt" for flyet er ikke samme tilstand, og en enkelt statuskolonne, der flader dem ud, vil før eller siden skrive "booket" over en halvt booket rejse.
Hold også de to sæt ændringsvilkår adskilt, og vis dem. Et vist total skjuler, at det er gratis at flytte datoerne på den ene halvdel og koster på den anden. Viser jeres front-end "skift datoer" som én knap, så beslut, hvad den gør, når kun den ene halvdel kan flyttes, før en kunde finder ud af det for jer. Det samme gælder avancen: lægger I den på per ydelse, som de fleste sælgere gør, er rejsens total to avancer, og en refusion på den ene halvdel skal vide, hvilken avance den giver tilbage. Penge er der, hvor en samlet rejse bliver dyr, fordi linjerne afregnes på forskellige tidslinjer, og refusionen for et fly kommer ikke, når hotellets afbestilling gør.
Hvor denne platform står
Lige ud: platformen udstiller API'er til fly og hoteller, og adgangen begynder med en samtale, ikke med en selvbetjeningsnøgle. Tjenester slås til per tenant, så en tenant, der sælger hoteller og ikke ture, slæber ikke turdelen med sig. Intet her lover ét kald, der booker begge halvdele atomart, og I bør ikke designe, som om det gjorde. Behandl dem som de to bookinger, de er, under en rejse, som er jeres.
Vil I se de faktiske kald og vilkår, før I bygger omkring dem, så start på siden om rejse-API'er og tag den rækkefølge med, I vil booke i. Overvejer I stadig, hvad gratis adgang giver jer, gennemgår gratis hotelbooking-API de slags gratis, der findes.
Hvad det koster at gøre det forkert
Den dyre version er den stille. En kunde har billet til en by, og værelset er væk, og det første, I hører om det, er en besked om natten fra en lufthavn. Billigere, men stadig virkeligt: en checkout, der viser ét beroligende total og så, efter et pristjek, et andet tal, som kunden ikke sagde ja til; en refusion, der giver flyet tilbage og glemmer hotellet; og en status, der siger "booket", mens leverandøren siger noget andet.
Intet af det kræver en smart løsning. Det kræver, at rejsen er et rigtigt objekt, at rækkefølgen er en beslutning, som nogen har skrevet ned, og at begge priser tjekkes igen i sidste øjeblik, før nogen af dem bindes. Byg det én gang, og checkouten kan se lige så enkel ud, som opgaven bad om.