Jämförelse av travel API: bedöm axlarna, inte leverantörerna

Du har tre leverantörspresentationer öppna i tre flikar. Var och en har en bild med en lång lista flygbolag, en bild med antal hotell, en sandbox, REST och JSON, och en supportadress. Du bygger ett kalkylark, sätter en bock i varje cell, och kalkylarket slutar oavgjort. Så brukar en jämförelse av travel API sluta när den görs som en funktionschecklista — och det är fel slut, för skillnaderna som avgör ditt nästa år syns först efter go-live: i bokningen som gick igenom hos leverantören men fick timeout på din sida, i återbetalningen som ingen kan hantera, i flygbolaget som stod på listan men inte går att ticketa via den här vägen.
Texten är skriven för utvecklaren eller den tekniska ansvariga som ska fatta beslutet och försvara det senare. Den rankar inga leverantörer. Den ger dig axlar att jämföra på, en testplan som lägger tiden på fel, och några frågor som snabbt visar om du pratar med en leverantör eller med en återförsäljare av någon annans leverantör.
Varför funktionschecklistan alltid slutar oavgjort
En checklista frågar om en förmåga finns. Nästan varje travel API kan svara ja på nästan varje rad, eftersom raderna är skrivna på marknadssidans nivå: sök, pris, boka, avboka, ticketa, webhooks, sandbox. Det som skiljer dem åt är inte om cancel finns, utan vad som händer när du anropar den på en ticketad bokning tolv timmar före avgång, på ett pris med avgift, via en väg där innehållet kom från en tredje part. En checklista har ingen kolumn för det.
Det finns ett andra problem. Den som fyller i checklistan är oftast leverantören själv. Du betygsätter deras egen beskrivning.
En jämförelse av travel API byggd på axlar, inte leverantörer
Byt rutnätet leverantör-mot-funktion mot axlar som du själv betygsätter, utifrån bevis du samlat under testperioden. Tabellen nedan är den vi själva skulle använda. Du kanske viktar raderna annorlunda — en ren hotellverksamhet bryr sig mindre om ticketing — och du bör ifrågasätta den innan du tar den till dig.
| Axel | Vad checklistan frågar | Vad du faktiskt ska ta reda på | Hur ett svagt svar låter |
|---|---|---|---|
| Täckning | Hur många flygbolag och hotell? | Hur många som går att söka, boka OCH ticketa eller bekräfta via detta API, på dina marknader | En enda stor siffra utan uppdelning |
| Djup | Finns det en avbokningsendpoint? | Vilka åtgärder efter bokning som är automatiserade per innehållskälla: void, refund, reissue, namnrättelse, tilläggstjänster | ”Det sköter vårt operationsteam” |
| Prisintegritet | Är priserna i realtid? | Hur ofta priset vid bokning skiljer sig från priset vid sökning, och hur API:et säger det | ”Priserna är alltid live” |
| Felsemantik | Är felen dokumenterade? | Om ett fel berättar vilket tillstånd bokningen är i, inte bara att något gick fel | En generisk felkod för allt |
| Idempotens | — | Om ett omförsökt book-anrop kan skapa en andra bokning | Tystnad, sedan ”det har vi inte sett” |
| Leverantör of record | — | Vems avtal, vems IATA-nummer, vems BSP biljetten går genom | ”Vi jobbar med alla stora GDS” |
| Åtkomst och support | Finns det en sandbox? | Vem svarar när ett live-PNR fastnar, och hur snabbt | Ett ärendeformulär och ingen namngiven kontakt |
Två av raderna saknar helt motsvarande fråga i checklistan. Det är ingen slump: det är raderna som kostar mest när de går fel, och de som en leverantörspresentation minst sannolikt tar upp självmant.
Täckning är inte djup
Listan med flygbolag är den mest vilseledande bilden i varje presentation. En lista med flera hundra bolag kan betyda flera olika saker, och bara en av dem är det du vill ha.
Vissa bolag kommer via ett GDS och går att boka och ticketa hela vägen. Vissa kommer via NDC-anslutningar, där sökningen kan fungera bra men servicen efter bokning — ändringar, delåterbetalningar, att lägga till ett bagage — fortfarande kan vara manuell för just det bolaget. Vissa är lågprisbolag vars innehåll aggregeras från en annan återförsäljare; du kan visa dem, ibland boka dem, och sedan kommer biljetten via en väg du inte styr, med en tidslinje du inte kan lova kunden. Och vissa står på listan för att ett pris en gång dök upp i ett sökresultat.
Ett bolag du kan visa men inte ticketa är ingen täckning. För en konsumentprodukt är det värre än att det saknas, för kunden väljer det, betalar och väntar sedan.
Hotell har samma form med andra ord. Ett antal anläggningar inkluderar både sådana som leverantören har mappat och sådana den inte har; statiska priser cachade förra veckan bredvid live-tillgänglighet; rum på allotment med release-period bredvid free sale. Fråga efter antalet som är live-bokningsbara i de städer du säljer, och fråga hur dubbletter mellan deras egna leverantörer slås ihop — samma hotell tre gånger till tre priser är ett supportärende som väntar på att hända.
Det praktiska testet är smalt. Skriv ner de tjugo rutter och tjugo hotellstäder som står för det mesta av din volym — säg Stockholm–London, Göteborg–Alicante, Kanarieöarna, Thailand — och be leverantören visa just dem fungera hela vägen i sandboxen: sök, pris, boka, ticketa eller bekräfta, avboka. En leverantör med djup gör det utan krångel. En leverantör med en bild börjar prata om bilden.
Vad du ska testa: felvägarna, inte de lyckliga vägarna
Varje sandbox bokar en enkel ekonomibiljett på en lugn rutt utan problem. Det är vad sandboxen byggdes för att visa. Din produktionstrafik kommer att tillbringa en betydande del av sitt liv på de andra vägarna, och testperioden är det enda billiga tillfället att se dem.
Kör den här listan och anteckna vad API:et returnerade bredvid vad som faktiskt gällde efteråt:
- Prisändring mellan sökning och bokning. Misslyckas book-anropet, går det igenom till det nya priset, eller kommer ett eget svar som ber dig bekräfta? Kan ditt UI se skillnaden utan att tolka en meddelandetext?
- Utgånget erbjudande. Sök, vänta längre än erbjudandets livslängd, boka sedan. Är utgången ett specifikt fel, eller samma fel som ”leverantören nere”?
- Slutsålt vid bokning. Lager som försvinner mellan prissättning och bokning. Vilket tillstånd är bokningen i, och släpps eventuell betalningsreservation?
- Omförsök efter timeout. Skicka en bokningsbegäran, bryt anslutningen innan svaret, och skicka den igen. Har du nu ett PNR eller två? Det här enda testet säger mer om en leverantör än resten av testperioden tillsammans.
- Bokning skapad, ticketing misslyckades. Kan API:et rapportera ett PNR som finns men inte är ticketat, och säger det sista ticketingdatum?
- Delvis misslyckande. En hotellförfrågan på flera rum där ett bekräftas och ett inte. En tur-och-retur där ut- och hemresa kommer från olika källor.
- Avbokning utanför det fria fönstret. Anges avgiften innan du bekräftar, eller upptäcks den på fakturan?
- Leverantörsavbrott. Fråga hur man simulerar ett. Om de inte kan, fråga hur deras kunder lärde sig hur det beter sig.
För varje fall betygsätter du två saker. Först: säger API:et sanningen om bokningens tillstånd? Sedan: kan din kod agera på den sanningen utan att en människa läser fritext? Ett API som misslyckas tydligt är lättare att leva med än ett som lyckas tvetydigt.
Vi har skrivit mer om flygdelen i det dokumentationen för flygboknings-API hoppar över, och om att designa en klient för långsamma hotelleverantörer i texten om hotelltillgänglighet. Båda passar bra ihop med en testplan.
Frågor som avslöjar en tunn aggregator
Det är inget fel med en aggregator. Det mesta reseinnehållet når de flesta säljare genom en. Risken är den tunna: ett lager som säljer vidare ett annat lagers API, lägger på en marginal och äger varken leverantörsavtalet eller den operativa desken. När något går sönder måste svaret färdas två företag uppströms och tillbaka.
Fem frågor får fram det snabbt:
- Vem är leverantör of record för den här bokningen? Vems avtal med flygbolaget eller hotellet vilar den på?
- Genom vems IATA-nummer och BSP går biljetten? Om svaret är ”en partners”, fråga vem som tar emot ADM:en när en prisregel bryts.
- Vad händer hos er när jag anropar cancel? Ett automatiskt anrop till leverantören, eller en kö som en människa plockar upp?
- Kan jag se felet uppströms? Ett tunt lager tenderar att platta till varje fel till en kod, eftersom det inte fullt förstår felen det tar emot.
- Vem ringer jag om en fastnad live-bokning, och vem ringer de? Räkna stegen.
Inget av svaren diskvalificerar på egen hand. En partners IATA-nummer kan vara okej om avtalet tydligt säger vem som bär debit memo-kostnaden. Det som spelar roll är att leverantören svarar exakt och snabbt. Vaga svar här är de svar du får senare, i produktion, vid en sämre timme.
Vad ett felval kostar
Integrationen är den billiga delen. De dyra delarna kommer senare och syns inte i någon uppskattning.
En bugg med dubbelbokning betyder en kund som debiterats två gånger och ett PNR du måste hitta och avboka för hand, kanske efter att det fria void-fönstret stängt. En bokning som lyckades uppströms medan din sida registrerade ett fel betyder en plats som hölls, sedan avbokades automatiskt, och en kund som tror sig vara bokad. Ett bolag du visade men inte kunde ticketa betyder återbetalning, en ursäkt och en kund som inte kommer tillbaka. En ADM för en prisregel som leverantörens väg bröt hamnar hos den som äger biljetten — se till att i förväg veta om det är du.
Sedan är det kostnaden för att byta. Varje egenhet du absorberar — en statuskod som betyder två saker, ett fält som ibland är en sträng — hamnar i din datamodell. Två år senare är valet av API inte längre en integration du byter ut på en sprint; det är formen på din bokningstabell. Det är det verkliga skälet att jämföra noggrant nu.
Hur vårt eget API passar in i ramverket
Vi erbjuder flyg- och hotell-API:er. Åtkomst börjar med ett samtal snarare än en självbetjäningsnyckel, vilket vissa utvecklare tycker är långsamt; skälet är att det är i samtalet frågorna ovan ställs åt båda hållen — vilka rutter och städer du behöver, vilket innehåll du faktiskt kommer att kunna ticketa eller bekräfta, och vem som hanterar vad efter bokningen. Om du gör en jämförelse, ta med den här listan. Sidan om travel APIs är där samtalet börjar.
Vad du än väljer, välj utifrån testloggen och inte presentationen. Presentationen berättar vad en leverantör vill vara. Felvägarna berättar vad den är.