Siirry sisältöön
Blogi

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

Tekravelin toimitus
Kirjoitettu tekoälyn avulla

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.

AkseliMitä tarkistuslista kysyyMitä oikeasti pitää selvittääMiltä heikko vastaus kuulostaa
KattavuusMontako lentoyhtiötä ja hotellia?Montako voi hakea, varata JA kirjoittaa tai vahvistaa tämän API:n kautta sinun markkinoillasiYksi iso luku ilman erittelyä
SyvyysOnko 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 eheysOvatko hinnat reaaliaikaisia?Kuinka usein varaushetken hinta poikkeaa hakuhetken hinnasta ja miten API kertoo siitä”Hinnat ovat aina live”
Virheiden semantiikkaOnko virheet dokumentoitu?Kertooko virhe, missä tilassa varaus on, eikä vain sitä, että jokin epäonnistuiYksi yleinen virhekoodi kaikkeen
Idempotenssi—Voiko uudelleen yritetty book-kutsu luoda toisen varauksenHiljaisuus, 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 tukiOnko sandbox?Kuka vastaa, kun live-PNR jumittuu, ja kuinka nopeastiTikettilomake 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:

  1. Kuka on tämän varauksen supplier of record? Kenen sopimukseen lentoyhtiön tai hotellin kanssa se perustuu?
  2. Kenen IATA-numeron ja BSP:n kautta lippu kulkee? Jos vastaus on ”kumppanin”, kysy, kuka saa ADM:n, kun hintasääntöä rikotaan.
  3. Mitä teidän päässänne tapahtuu, kun kutsun cancel? Automaattinen kutsu toimittajalle vai jono, josta ihminen poimii sen?
  4. Näenkö ylävirran virheen? Ohut kerros pyrkii litistämään jokaisen virheen yhdeksi koodiksi, koska se ei täysin ymmärrä vastaanottamiaan virheitä.
  5. 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.

Tekravelin toimitus

Matkailuteknologian osasto

Tekravelin matkailuteknologian osasto kirjoittaa alalle: toimistojen omistajille, konsolidaattoreille ja heitä integroiville kehittäjille. Jokainen juttu tarkistetaan kuvatulla alustalla ennen julkaisua.