Sammenligning av travel API: vurder aksene, ikke leverandørene

Du har tre leverandørpresentasjoner åpne i tre faner. Hver av dem har et lysbilde med en lang liste over flyselskaper, et lysbilde med antall hoteller, en sandbox, REST og JSON, og en supportadresse. Du lager et regneark, setter en hake i hver celle, og regnearket ender uavgjort. Slik ender som regel en sammenligning av travel API når den gjøres som en funksjonssjekkliste — og det er feil slutt, for forskjellene som avgjør ditt neste år viser seg først etter go-live: i bestillingen som gikk gjennom hos leverandøren men fikk timeout hos deg, i refusjonen ingen klarer å behandle, i flyselskapet som sto på listen men ikke kan billetteres via denne ruten.
Denne teksten er for utvikleren eller den tekniske lederen som skal ta avgjørelsen og forsvare den etterpå. Den rangerer ikke leverandører. Den gir deg akser å sammenligne langs, en testplan som bruker tiden på feil, og noen få spørsmål som raskt viser om du snakker med en leverandør eller med en videreselger av noen andres leverandør.
Hvorfor funksjonssjekklisten alltid ender uavgjort
En sjekkliste spør om en funksjon finnes. Nesten alle travel API kan svare ja på nesten hver rad, fordi radene er skrevet på markedsføringssidens nivå: søk, pris, bestill, avbestill, billetter, webhooks, sandbox. Det som skiller dem er ikke om cancel finnes, men hva som skjer når du kaller den på en billettert bestilling tolv timer før avgang, på en pris med gebyr, via en rute der innholdet kom fra en tredjepart. Det har sjekklisten ingen kolonne for.
Det finnes et problem til. Den som fyller ut sjekklisten er som regel leverandøren selv. Du gir poeng til deres egen beskrivelse.
En sammenligning av travel API bygd på akser, ikke leverandører
Bytt ut rutenettet leverandør mot funksjon med akser du selv scorer, ut fra bevis du samlet i prøveperioden. Tabellen under er den vi selv ville brukt. Du vekter kanskje radene annerledes — en ren hotellvirksomhet bryr seg mindre om billettering — og du bør krangle med den før du tar den i bruk.
| Akse | Hva sjekklisten spør om | Hva du faktisk skal finne ut | Slik høres et svakt svar ut |
|---|---|---|---|
| Dekning | Hvor mange flyselskaper og hoteller? | Hvor mange som kan søkes, bestilles OG billetteres eller bekreftes via dette API-et, i dine markeder | Ett stort tall uten oppdeling |
| Dybde | Finnes det et endepunkt for avbestilling? | Hvilke handlinger etter bestilling som er automatisert per innholdskilde: void, refund, reissue, navnerettelse, tilleggstjenester | «Det tar operations-teamet vårt seg av» |
| Prisintegritet | Er prisene i sanntid? | Hvor ofte prisen ved bestilling avviker fra prisen ved søk, og hvordan API-et sier fra | «Prisene er alltid live» |
| Feilsemantikk | Er feilene dokumentert? | Om en feil forteller hvilken tilstand bestillingen er i, ikke bare at noe feilet | Én generisk feilkode for alt |
| Idempotens | — | Om et gjentatt book-kall kan opprette en ekstra bestilling | Stillhet, deretter «det har vi ikke sett» |
| Leverandør of record | — | Hvem sin kontrakt, hvem sitt IATA-nummer, hvem sin BSP billetten går gjennom | «Vi jobber med alle de store GDS-ene» |
| Tilgang og støtte | Finnes det en sandbox? | Hvem svarer når et live-PNR henger, og hvor raskt | Et saksskjema og ingen navngitt kontakt |
To av radene har ikke noe sjekklistespørsmål i det hele tatt. Det er ikke tilfeldig: det er radene som koster mest når noe går galt, og de en leverandørpresentasjon minst sannsynlig nevner av seg selv.
Dekning er ikke dybde
Listen over flyselskaper er det mest villedende lysbildet i enhver presentasjon. En liste på flere hundre selskaper kan bety flere ulike ting, og bare én av dem er det du vil ha.
Noen kommer via et GDS og kan bestilles og billetteres hele veien. Noen kommer via NDC-tilkoblinger, der søket kan fungere godt, men oppfølging etter bestilling — endringer, delvise refusjoner, å legge til en bagasje — fortsatt kan være manuell for akkurat det selskapet. Noen er lavprisselskaper der innholdet er samlet inn fra en annen videreselger; du kan vise dem, noen ganger bestille dem, og så kommer billetten via en vei du ikke styrer, med en tidslinje du ikke kan love kunden. Og noen står på listen fordi en pris en gang dukket opp i et søkesvar.
Et selskap du kan vise men ikke billettere, er ikke dekning. For et detaljhandelsprodukt er det verre enn at det mangler, fordi kunden velger det, betaler og så venter.
Hoteller har samme form med andre ord. Et antall overnattingssteder omfatter både de leverandøren har mappet og de den ikke har; statiske priser bufret forrige uke ved siden av live-tilgjengelighet; rom på allotment med release-periode ved siden av free sale. Spør etter antallet som er live-bestillbart i byene du selger, og spør hvordan duplikater på tvers av deres egne leverandører slås sammen — det samme hotellet tre ganger til tre priser er en supportsak som venter på å skje.
Den praktiske testen er smal. Skriv ned de tjue rutene og tjue hotellbyene som utgjør mesteparten av volumet ditt — for eksempel Oslo–London, Bergen–Alicante, Gran Canaria, Thailand — og be leverandøren vise akkurat dem fungere hele veien i sandboxen: søk, pris, bestill, billetter eller bekreft, avbestill. En leverandør med dybde gjør det uten fuss. En leverandør med et lysbilde begynner å snakke om lysbildet.
Hva du skal teste: feilveiene, ikke de lykkelige veiene
Hver sandbox bestiller en enveisbillett på økonomiklasse på en rolig rute uten problemer. Det er det sandboxen ble laget for å vise. Produksjonstrafikken din vil tilbringe en betydelig del av livet sitt på de andre veiene, og prøveperioden er det eneste billige tidspunktet for å se dem.
Kjør denne listen, og noter hva API-et returnerte ved siden av hva som faktisk var sant etterpå:
- Prisendring mellom søk og bestilling. Feiler book-kallet, går det gjennom til ny pris, eller kommer det et eget svar som ber deg bekrefte? Kan UI-et ditt se forskjellen uten å tolke en meldingstekst?
- Utløpt tilbud. Søk, vent lenger enn tilbudets levetid, og bestill. Er utløpet en egen feil, eller samme feil som «leverandør nede»?
- Utsolgt ved bestilling. Kapasitet som forsvinner mellom prising og bestilling. Hvilken tilstand er bestillingen i, og frigjøres en eventuell betalingsreservasjon?
- Nytt forsøk etter timeout. Send en bestillingsforespørsel, bryt tilkoblingen før svaret, og send den på nytt. Har du nå ett PNR eller to? Denne ene testen sier mer om en leverandør enn resten av prøveperioden til sammen.
- Bestilling opprettet, billettering feilet. Kan API-et rapportere et PNR som finnes men ikke er billettert, og oppgir det billetteringsfristen?
- Delvis feil. En hotellforespørsel på flere rom der ett bekreftes og ett ikke. En tur-retur der ut- og hjemreise kommer fra ulike kilder.
- Avbestilling utenfor det gratis vinduet. Oppgis gebyret før du bekrefter, eller oppdages det på fakturaen?
- Leverandørbrudd. Spør hvordan man simulerer et. Kan de ikke, spør hvordan kundene deres lærte hvordan det oppfører seg.
For hvert tilfelle scorer du to ting. Først: forteller API-et sannheten om bestillingens tilstand? Deretter: kan koden din handle på den sannheten uten at et menneske leser fritekst? Et API som feiler tydelig er lettere å leve med enn et som lykkes tvetydig.
Vi har skrevet mer om flysiden i det dokumentasjonen til et flybestillings-API utelater, og om å designe en klient for trege hotelleverandører i artikkelen om hotelltilgjengelighet. Begge passer godt sammen med en testplan.
Spørsmål som avslører en tynn aggregator
Det er ikke noe galt med en aggregator. Det meste av reiseinnholdet når de fleste selgere gjennom en. Risikoen er den tynne: et lag som videreselger et annet lags API, legger på en margin og verken eier leverandørkontrakten eller den operative desken. Når noe ryker, må svaret reise to selskaper oppstrøms og tilbake.
Fem spørsmål får det raskt fram:
- Hvem er leverandør of record for denne bestillingen? Hvem sin kontrakt med flyselskapet eller hotellet hviler den på?
- Gjennom hvem sitt IATA-nummer og BSP går billetten? Er svaret «en partners», spør hvem som mottar ADM-en når en prisregel brytes.
- Hva skjer hos dere når jeg kaller cancel? Et automatisk kall til leverandøren, eller en kø som et menneske plukker opp?
- Kan jeg se feilen oppstrøms? Et tynt lag har en tendens til å presse alle feil ned i én kode, fordi det ikke fullt ut forstår feilene det mottar.
- Hvem ringer jeg om en fastlåst live-bestilling, og hvem ringer de? Tell leddene.
Ingen av svarene diskvalifiserer alene. En partners IATA-nummer kan være greit hvis kontrakten sier tydelig hvem som bærer debit memo-en. Det som teller, er at leverandøren svarer presist og raskt. Vage svar her er svarene du får senere, i produksjon, på et verre tidspunkt.
Hva et feil valg koster
Integrasjonen er den billige delen. De dyre delene kommer senere og står ikke i noe estimat.
En feil med dobbeltbestilling betyr en kunde som er belastet to ganger og et PNR du må finne og kansellere manuelt, kanskje etter at det gratis void-vinduet har stengt. En bestilling som lyktes oppstrøms mens din side registrerte en feil, betyr et sete som ble holdt, så automatisk kansellert, og en kunde som tror de er bestilt. Et selskap du viste men ikke kunne billettere, betyr refusjon, en unnskyldning og en kunde som ikke kommer tilbake. En ADM for en prisregel leverandørens rute brøt, havner hos den som eier billetten — sørg for å vite på forhånd om det er deg.
Så er det kostnaden ved å bytte. Hver særhet du absorberer — en statuskode som betyr to ting, et felt som noen ganger er en streng — havner i datamodellen din. To år senere er API-valget ikke lenger en integrasjon du bytter ut på en sprint; det er formen på bestillingstabellen din. Det er den egentlige grunnen til å sammenligne grundig nå.
Hvordan vårt eget API passer inn
Vi tilbyr fly- og hotell-API-er. Tilgang starter med en samtale heller enn en selvbetjeningsnøkkel, noe enkelte utviklere synes er tregt; grunnen er at det er i samtalen spørsmålene over stilles begge veier — hvilke ruter og byer du trenger, hvilket innhold du faktisk vil kunne billettere eller bekrefte, og hvem som håndterer hva etter bestillingen. Holder du på med en sammenligning, ta med deg denne listen. Siden om travel APIs er der samtalen starter.
Uansett hva du velger, velg ut fra testloggen og ikke presentasjonen. Presentasjonen forteller hva en leverandør vil være. Feilveiene forteller hva den er.