Travel API -vertailu: arvioi akseleita, älä toimittajia

Sinulla on kolme toimittajan esitystä auki kolmessa välilehdessä. Jokaisessa on dia, jossa on pitkä lista lentoyhtiöitä, dia hotellien määrästä, sandbox, REST ja JSON sekä tuen sähköpostiosoite. Teet taulukon, laitat rastin jokaiseen soluun, ja taulukko päättyy tasapeliin. Näin travel API -vertailu yleensä päättyy, kun se tehdään ominaisuuslistana — ja se on väärä loppu, koska erot, jotka ratkaisevat seuraavan vuotesi, näkyvät vasta käyttöönoton jälkeen: varauksessa, joka onnistui toimittajalla mutta aikakatkaistiin sinun päässäsi, hyvityksessä, jota kukaan ei osaa käsitellä, lentoyhtiössä, joka oli listalla mutta jolle ei voi kirjoittaa lippua tätä reittiä.
Tämä teksti on kehittäjälle tai tekniselle vetäjälle, jonka pitää tehdä päätös ja puolustaa sitä myöhemmin. Se ei aseta toimittajia paremmuusjärjestykseen. Se antaa vertailuakselit, testisuunnitelman, joka käyttää aikansa virhetilanteisiin, ja lyhyen kysymyslistan, josta näet nopeasti, puhutko toimittajan vai jonkun toisen toimittajan jälleenmyyjän kanssa.
Miksi ominaisuuslista päättyy aina tasapeliin
Tarkistuslista kysyy, onko jokin kyvykkyys olemassa. Melkein jokainen travel API vastaa kyllä melkein jokaiseen riviin, koska rivit on kirjoitettu markkinointisivun tasolla: haku, hinta, varaus, peruutus, lipunkirjoitus, webhookit, sandbox. Niitä erottaa toisistaan se, mitä tapahtuu, kun kutsut cancel-toimintoa jo kirjoitetulle lipulle kaksitoista tuntia ennen lähtöä, hinnalle, jossa on peruutusmaksu, reitin kautta, jolla sisältö tuli kolmannelta osapuolelta — ei se, onko toiminto olemassa. Tarkistuslistassa ei ole tälle saraketta.
Toinenkin ongelma on. Listan täyttää yleensä toimittaja itse. Pisteytät heidän omaa kuvaustaan.
Travel API -vertailu akseleilla, ei toimittajilla
Korvaa toimittaja kertaa ominaisuus -ruudukko akseleilla, jotka pisteytät itse kokeilujakson aikana keräämäsi näytön perusteella. Alla oleva taulukko on se, jota itse käyttäisimme. Saatat painottaa rivejä toisin — pelkkiä hotelleja myyvä yritys välittää lipunkirjoituksesta vähemmän — ja siitä kannattaa väitellä ennen kuin otat sen käyttöön.
| Akseli | Mitä tarkistuslista kysyy | Mitä oikeasti pitää selvittää | Miltä heikko vastaus kuulostaa |
|---|---|---|---|
| Kattavuus | Montako lentoyhtiötä ja hotellia? | Montako voi hakea, varata JA kirjoittaa tai vahvistaa tämän API:n kautta sinun markkinoillasi | Yksi iso luku ilman erittelyä |
| Syvyys | Onko peruutuksen endpoint? | Mitkä varauksen jälkeiset toiminnot on automatisoitu sisältölähteittäin: void, refund, reissue, nimenkorjaus, lisäpalvelut | ”Operatiivinen tiimimme hoitaa sen” |
| Hinnan eheys | Ovatko hinnat reaaliaikaisia? | Kuinka usein varaushetken hinta poikkeaa hakuhetken hinnasta ja miten API kertoo siitä | ”Hinnat ovat aina live” |
| Virheiden semantiikka | Onko virheet dokumentoitu? | Kertooko virhe, missä tilassa varaus on, eikä vain sitä, että jokin epäonnistui | Yksi yleinen virhekoodi kaikkeen |
| Idempotenssi | — | Voiko uudelleen yritetty book-kutsu luoda toisen varauksen | Hiljaisuus, sitten ”emme ole nähneet sellaista” |
| Supplier of record | — | Kenen sopimus, kenen IATA-numero, kenen BSP:n kautta lippu kulkee | ”Teemme yhteistyötä kaikkien suurten GDS-järjestelmien kanssa” |
| Pääsy ja tuki | Onko sandbox? | Kuka vastaa, kun live-PNR jumittuu, ja kuinka nopeasti | Tikettilomake eikä nimettyä yhteyshenkilöä |
Kahdelle riville ei tarkistuslistassa ole kysymystä lainkaan. Se ei ole sattumaa: ne ovat rivit, jotka maksavat eniten, kun jokin menee pieleen, ja joita toimittajan esitys todennäköisimmin jättää mainitsematta.
Kattavuus ei ole syvyyttä
Lentoyhtiölista on jokaisen esityksen harhaanjohtavin dia. Usean sadan yhtiön lista voi tarkoittaa monta eri asiaa, ja vain yksi niistä on se, mitä haluat.
Osa yhtiöistä tulee GDS:n kautta, ja ne voi varata ja kirjoittaa alusta loppuun. Osa tulee NDC-yhteyksien kautta, jolloin haku voi toimia hyvin, mutta varauksen jälkeinen palvelu — muutokset, osittaiset hyvitykset, laukun lisääminen — voi olla kyseisellä yhtiöllä yhä käsityötä. Osa on halpalentoyhtiöitä, joiden sisältö kootaan toiselta jälleenmyyjältä; voit näyttää ne, joskus varata ne, ja sitten lippu saapuu reittiä, jota et hallitse, aikataululla, jota et voi luvata asiakkaalle. Ja osa on listalla, koska jokin hinta kerran ilmestyi hakuvastaukseen.
Yhtiö, jonka voit näyttää mutta et kirjoittaa, ei ole kattavuutta. Kuluttajatuotteelle se on pahempi kuin puuttuminen, koska asiakas valitsee sen, maksaa ja sitten odottaa.
Hotelleissa muoto on sama, sanat vain toiset. Kohteiden määrä sisältää sekä toimittajan mappaamat että mappaamattomat kohteet; viime viikolla välimuistiin tallennetut staattiset hinnat live-saatavuuden vieressä; allotment-huoneet release-aikoineen free sale -kapasiteetin vieressä. Kysy määrää, joka on live-varattavissa niissä kaupungeissa, joihin myyt, ja kysy, miten heidän omien toimittajiensa väliset kaksoiskappaleet yhdistetään — sama hotelli kolmesti kolmella hinnalla on tukipyyntö, joka odottaa tapahtumistaan.
Käytännön testi on kapea. Kirjoita ylös ne kaksikymmentä reittiä ja kaksikymmentä hotellikaupunkia, jotka muodostavat suurimman osan volyymistäsi — vaikkapa Helsinki–Lontoo, Helsinki–Bangkok, Kanariansaaret, Tukholma — ja pyydä toimittajaa näyttämään juuri ne toimimassa sandboxissa alusta loppuun: haku, hinta, varaus, lipunkirjoitus tai vahvistus, peruutus. Toimittaja, jolla on syvyyttä, tekee sen ilman mutkia. Toimittaja, jolla on dia, alkaa puhua diasta.
Mitä kokeilussa testataan: virhepolut, eivät onnelliset polut
Jokainen sandbox varaa onnistuneesti yhdensuuntaisen turistiluokan lipun hiljaiselle reitille. Sitä varten se on rakennettu. Tuotantoliikenteesi viettää merkittävän osan elämästään muilla poluilla, ja kokeilujakso on ainoa halpa hetki nähdä ne.
Käy tämä lista läpi ja kirjaa, mitä API palautti, sen viereen, mikä oli jälkikäteen totta:
- Hinnanmuutos haun ja varauksen välillä. Epäonnistuuko book-kutsu, onnistuuko se uudella hinnalla vai palauttaako se erillisen vastauksen, joka pyytää vahvistusta? Erottaako käyttöliittymäsi nämä jäsentämättä viestitekstiä?
- Vanhentunut tarjous. Hae, odota tarjouksen voimassaoloa pidempään ja varaa. Onko vanhentuminen oma virheensä vai sama kuin ”toimittaja alhaalla”?
- Loppuunmyyty varaushetkellä. Kapasiteetti, joka katoaa hinnoittelun ja varauksen välillä. Missä tilassa varaus on, ja vapautetaanko maksun katevaraus?
- Uudelleenyritys aikakatkaisun jälkeen. Lähetä varauspyyntö, katkaise yhteys ennen vastausta ja lähetä se uudelleen. Onko sinulla nyt yksi PNR vai kaksi? Tämä yksi testi kertoo toimittajasta enemmän kuin koko muu kokeilu yhteensä.
- Varaus luotu, lipunkirjoitus epäonnistui. Pystyykö API raportoimaan PNR:n, joka on olemassa mutta jota ei ole kirjoitettu, ja kertooko se lipunkirjoituksen määräajan?
- Osittainen epäonnistuminen. Usean huoneen hotellipyyntö, jossa yksi vahvistuu ja toinen ei. Meno-paluu, jossa meno- ja paluulento tulevat eri lähteistä.
- Peruutus maksuttoman ikkunan ulkopuolella. Kerrotaanko maksu ennen vahvistusta vai selviääkö se laskulta?
- Toimittajan käyttökatko. Kysy, miten sellainen simuloidaan. Jos he eivät osaa, kysy, miten heidän asiakkaansa oppivat, miten järjestelmä käyttäytyy.
Jokaisessa tapauksessa pisteytät kaksi asiaa. Ensinnäkin: kertooko API totuuden varauksen tilasta? Toiseksi: voiko koodisi toimia sen totuuden perusteella ilman, että ihminen lukee vapaata tekstiä? Selkeästi epäonnistuvan API:n kanssa on helpompi elää kuin sellaisen, joka onnistuu monitulkintaisesti.
Lentopuolesta olemme kirjoittaneet tarkemmin jutussa mistä lentovaraus-API:n dokumentaatio vaikenee ja hitaiden hotellitoimittajien asiakasohjelman suunnittelusta hotellien saatavuutta käsittelevässä tekstissä. Molemmat sopivat testisuunnitelman rinnalle.
Kysymykset, jotka paljastavat ohuen aggregaattorin
Aggregaattorissa ei ole mitään vikaa. Suurin osa matkailusisällöstä päätyy useimmille myyjille jonkin kautta. Riski on ohut aggregaattori: kerros, joka jälleenmyy toisen kerroksen API:a, lisää katteen eikä omista toimittajasopimusta eikä operatiivista deskiä. Kun jokin hajoaa, vastauksen pitää kulkea kaksi yritystä ylävirtaan ja takaisin.
Viisi kysymystä tuo sen nopeasti esiin:
- Kuka on tämän varauksen supplier of record? Kenen sopimukseen lentoyhtiön tai hotellin kanssa se perustuu?
- Kenen IATA-numeron ja BSP:n kautta lippu kulkee? Jos vastaus on ”kumppanin”, kysy, kuka saa ADM:n, kun hintasääntöä rikotaan.
- Mitä teidän päässänne tapahtuu, kun kutsun cancel? Automaattinen kutsu toimittajalle vai jono, josta ihminen poimii sen?
- Näenkö ylävirran virheen? Ohut kerros pyrkii litistämään jokaisen virheen yhdeksi koodiksi, koska se ei täysin ymmärrä vastaanottamiaan virheitä.
- Kenelle soitan jumittuneesta live-varauksesta, ja kenelle he soittavat? Laske välikädet.
Mikään vastaus ei yksinään hylkää toimittajaa. Kumppanin IATA-numero voi olla kunnossa, jos sopimuksessa sanotaan selvästi, kuka kantaa debit memon. Olennaista on, että toimittaja vastaa täsmällisesti ja nopeasti. Epämääräiset vastaukset tässä ovat niitä vastauksia, jotka saat myöhemmin tuotannossa huonompaan aikaan.
Mitä väärä valinta maksaa
Integraatio on halpa osa. Kalliit osat tulevat myöhemmin, eikä niitä näy missään arviossa.
Kaksoisvarausbugi tarkoittaa asiakasta, jota on veloitettu kahdesti, ja PNR:ää, joka pitää löytää ja perua käsin, ehkä vasta maksuttoman void-ikkunan sulkeuduttua. Varaus, joka onnistui ylävirrassa samalla kun sinun pääsi kirjasi epäonnistumisen, tarkoittaa pidettyä paikkaa, sitten automaattista peruutusta ja asiakasta, joka luulee olevansa varattuna. Yhtiö, jonka näytit mutta jolle et voinut kirjoittaa lippua, tarkoittaa hyvitystä, anteeksipyyntöä ja asiakasta, joka ei palaa. ADM hintasäännöstä, jonka toimittajan reitti rikkoi, päätyy lipun omistajalle — varmista etukäteen, oletko se sinä.
Sitten on vaihtamisen hinta. Jokainen omituisuus, jonka imet itseesi — tilakoodi, joka tarkoittaa kahta asiaa, kenttä, joka on joskus merkkijono — päätyy tietomalliisi. Kahden vuoden päästä API-valinta ei ole enää integraatio, jonka vaihdat yhdessä sprintissä; se on varaustaulusi muoto. Se on todellinen syy vertailla huolella nyt.
Miten oma API:mme sopii tähän kehikkoon
Tarjoamme lento- ja hotelli-API:t. Pääsy alkaa keskustelulla eikä itsepalveluavaimella, mikä tuntuu joistain kehittäjistä hitaalta; syy on se, että juuri siinä keskustelussa yllä olevat kysymykset esitetään molempiin suuntiin — mitä reittejä ja kaupunkeja tarvitset, mitä sisältöä voit oikeasti kirjoittaa tai vahvistaa ja kuka hoitaa mitäkin varauksen jälkeen. Jos teet vertailua, ota tämä lista mukaan. Travel APIs -sivu on paikka, josta keskustelu alkaa.
Valitsitpa mitä tahansa, valitse kokeilun lokin enkä esityksen perusteella. Esitys kertoo, mikä toimittaja haluaa olla. Virhepolut kertovat, mikä se on.