Hoppa till innehållet
Blogg

Boknings-API för hotell och flyg: en resa, två bokningar

Tekravel Redaktion
Skriven med hjälp av AI

Ärendet säger: "lägg till hotell i flygflödet, en checkout, en totalsumma". En rimlig begäran från en produktchef, och den låter som en dags jobb, eftersom ni redan har flygsökning och redan har en betalsida. Tre veckor senare bråkar teamet om vad som ska hända när flygbolaget bekräftar och hotellet inte gör det. Ett boknings-API för hotell och flyg är inte en integration med två sorters resultat. Det är två integrationer som delar en varukorg.

Ju tidigare koden erkänner det, desto mindre av den skrivs om. Det som följer är delen som integrationsguiderna hoppar över: hur de två halvorna skiljer sig åt, vilken ni binder först och vad en resa måste vara i er datamodell.

De två halvorna beter sig inte lika

Båda kommer tillbaka som JSON med ett pris och en referens, så på tråden ser de lika ut. De är inte lika i vad de lovar när ni väl har referensen.

FrågaFlygHotell
Vad ni håller efter bokningenEn reservation (PNR) som ännu inte är en biljettEn bekräftelse som oftast redan är det ni sålde
Hur länge priset gällerTills priset räknas om vid bokning, och det kan skilja sig från sökningenTills priset löper ut, och ett pris kan ändras mellan tillgänglighet och bokning
Vad som bekräftar denUtfärdandet av biljetten, ofta mot en tidsgränsLeverantörens bekräftelse, ibland direkt, ibland väntande
Hur den ångrasEn void om ni hinner tidigt, annars en återbetalning enligt prisreglerna, ofta med avgiftEn avbokning enligt prisets egen policy, för många priser gratis fram till en brytpunkt
Vad som ändrar beloppet sentPris, skatter, ibland prisets valutaSkatter och avgifter som betalas på plats, måltidsupplägget, rummet som faktiskt tilldelas

Ni kan vara oense om en rad, eftersom leverantörer skiljer sig, men inte om formen: den ena halvan har ett utfärdandesteg och den andra ett avbokningsfönster, och de ligger inte i fas. Flygsidan av förloppet tog vi upp i integration av ett flygboknings-API och problemet med den långsamma leverantören på hotellsidan i klientdesign för ett API för hotelltillgänglighet. Den här texten börjar där de slutar, i skarven.

Vilken bokar ni först?

Ingen berättar att det här är ett designbeslut, och det är just det som avgör vad ett fel kostar.

Säg att en kund köper flyg och hotell för samma datum. Ni skickar den ena bokningen och sedan den andra. Tre saker kan hända: båda lyckas, en misslyckas, eller en misslyckas efter att den andra redan har lyckats. Det första är en bra dag. De andra två avgör er supportkö.

Utfärdar ni flyget först och hotellet sedan säger nej, har ni en kund med en plats till en stad och inget rum, som redan har debiterats, och en återbetalning på en biljett med avgift. Bokar ni hotellet först och flyget sedan misslyckas, håller ni ett rum som ofta kan avbokas gratis, så lagningen är billig. Den omvända risken finns också, eftersom ett hotellpris som inte går att avboka är det värsta att hålla, så läs prisets avbokningsvillkor innan ni låter det gå först.

Det här är en tumregel, inte en lag, och poängen är att välja ordningen med avsikt. Bind den halva som är lättast att ångra före den som är svårare, kontrollera priset på båda precis innan någon av dem binds, och skriv ner vad ni gör i vart och ett av de tre utfallen. Granskare frågar sällan. Kunder får alltid reda på det.

En resa, två bokningar

Formen som håller är en resepost som äger två bokningar, var och en med egen referens, egen status och egna villkor. Kunden ser en totalsumma. Er databas ser två rader, och totalen är en summa ni räknar fram, inte något som finns hos leverantören.

Håll de två statusarna isär. "Bekräftad" för hotellet och "utfärdad" för flyget är inte samma tillstånd, och en enda statuskolumn som plattar till dem kommer förr eller senare att säga "bokad" om en halvbokad resa.

Håll också de två uppsättningarna ändringsvillkor isär, och visa dem. En visad totalsumma döljer att det är gratis att flytta datumen på ena halvan och kostar på den andra. Visar er front-end "ändra datum" som en enda knapp, bestäm vad den gör när bara ena halvan kan flyttas, innan en kund tar reda på det åt er. Detsamma gäller påslaget: lägger ni det per tjänst, som de flesta säljare gör, är resans total två påslag, och en återbetalning på ena halvan måste veta vilket påslag den lämnar tillbaka. Pengar är där en kombinerad resa blir dyr, eftersom raderna regleras på olika tidslinjer, och en återbetalning för flyget kommer inte när hotellets avbokning gör det.

Var den här plattformen står

Rakt på sak: plattformen exponerar API:er för flyg och hotell, och åtkomsten börjar med ett samtal, inte med en självbetjäningsnyckel. Tjänster slås på per tenant, så en tenant som säljer hotell och inte turer bär inte med sig turdelen. Inget här lovar ett enda anrop som bokar båda halvorna atomärt, och ni bör inte designa som om det gjorde det. Behandla dem som de två bokningar de är, under en resa som är er.

Vill ni se de faktiska anropen och villkoren innan ni bygger kring dem, börja på sidan om rese-API:er och ta med ordningen ni tänker boka i. Funderar ni fortfarande på vad gratis åtkomst ger, går gratis hotellboknings-API igenom sorterna av gratis.

Vad det kostar att göra fel

Den dyra versionen är den tysta. En kund har biljett till en stad och rummet är borta, och det första ni hör om det är ett meddelande på natten från en flygplats. Billigare men fortfarande verkligt: en checkout som visar en lugnande totalsumma och sedan, efter en priskontroll, en andra siffra som kunden inte gått med på; en återbetalning som lämnar tillbaka flyget och glömmer hotellet; och en status som säger "bokad" medan leverantören säger något annat.

Inget av det kräver en smart lösning. Det kräver att resan är ett riktigt objekt, att ordningen är ett beslut som någon har skrivit ner, och att båda priserna kontrolleras igen i sista stund innan någon av dem binds. Bygg det en gång så kan checkouten se lika enkel ut som ärendet bad om.

Tekravel Redaktion

Desk för resetechnologi

Tekravels desk för resetechnologi skriver för branschen: byråägare, konsolidatorer och utvecklarna som integrerar dem. Varje artikel kontrolleras mot plattformen den beskriver innan den publiceras.