Siirry sisältöön
Blogi

Paras lentovaraus-API: kertokaa ensin, mitä rakennatte

Tekravelin toimitus
Kirjoitettu tekoälyn avulla

Toimeksianto kuuluu: etsikää paras lentovaraus-API. Avaatte siis kolme vertailusivua, ja ne asettavat saman kourallisen nimiä kolmeen eri järjestykseen, kukin oman rastitaulukkonsa kera. Kolmannen sivun kohdalla huomaatte, mitä yksikään ei kysynyt: mitä asiakkaalle tapahtuu, kun hakutulokset ovat palanneet.

Tuo puuttuva kysymys on koko vastaus. Paras lentovaraus-API sivulle, joka lähettää kävijät lentoyhtiön sivustolle, on huono valinta sivustolle, joka ottaa varauksen ja korttimaksun itse. Eikä kumpikaan sovi sisäiseen työkaluun, jota matkatoimiston henkilöstö käyttää koko päivän. Haku, hinta ja varaus näyttävät jokaisessa dokumentaatiossa samoilta. Erot ovat niiden alla, ja se, mikä eroista satuttaa teitä, riippuu kokonaan tuotteesta.

Kolme tuotetta, joita kaikkia kutsutaan "lentovaraussivustoksi"

Ensimmäinen on vertailu- tai inspiraatiosivu: näytä hinnat, linkitä eteenpäin, älä koskaan koske lippuun. Tässä API on lähes pelkkää hakua. Teitä kiinnostaa, kuinka laajoja ja tuoreita tulokset ovat ja onko näytetty hinta riittävän lähellä sitä, jonka kävijä näkee perillä. Mikään järjestelmässänne ei koskaan joudu tekemään voidia, hyvitystä tai uudelleenkirjoitusta, joten toimittajan vahvuus siinä menee teidän kohdallanne hukkaan.

Toinen myy. Kävijä maksaa teille, te varaatte, ja siitä hetkestä varauksen elinkaari on teidän: vahvistakaa hinta ennen veloitusta, hoitakaa hitaasti vastaava lentoyhtiö, mitätöikää samana päivänä, hyvittäkää myöhemmin, kirjoittakaa lippu uudelleen, kun asiakas vaihtaa päivää. Tässä tuotteessa haun endpoint on helppo osa. Valinnan ratkaisee se, mikä tulee sen jälkeen.

Kolmas on toimiston oma työkalu henkilöstölle, jolla on jo omat toimittajasuhteet. Raaka haku ei ole pointti. Ratkaisevaa on, että toimiston oma neuvoteltu sisältö näkyy, että alatoimistot pidetään luottorajoissa, että katteet lisätään ennen kuin kukaan näkee hintaa ja että kuun lopussa on raportit. API, joka on erinomainen toiselle tuotteelle, voi silti olla tässä väärä perusta.

Se kannattaa sanoa suoraan: sama API ei voi olla paras kaikissa kolmessa. Jos ranking väittää niin, se ei ole kohdannut toista.

Vertailemisen arvoiset ominaisuudet ja kuka niihin nojaa

Karsikaa ominaisuustaulukko riveihin, joista kehittäjä voisi aidosti olla eri mieltä. Kukin tuote nojaa omaan osajoukkoonsa, ja loput voi huoletta ohittaa.

OminaisuusUudelleenohjaussivuMyy ja ottaa maksunToimiston henkilöstön työkalu
Kuinka vanha näytetty hinta saa olla ennen vahvistustaMerkitsee vähänRatkaiseva: veloitatte sen perusteellaMerkitsee, henkilöstö tarjoaa sen perusteella
Mitä varaus palauttaa, kun lentoyhtiö on hidasEi koskeRatkaisevaMerkitsee
Kuka voi mitätöidä ja hyvittää, ja miten sitä pyydetäänEi koskeRatkaisevaRatkaiseva
Miten varaus, jonka lopputulos on tuntematon, ratkaistaanEi koskeRatkaiseva: kortti on ehkä jo veloitettuMerkitsee
Pätevätkö toimiston oma sisältö ja luottosäännötEi koskeJoskusRatkaiseva
Kuinka paljon testikäytös eroaa tuotannostaMatalaKorkeaKorkea

Lukekaa oma sarakkeenne ja ohittakaa muut. Rahaa maksava virhe on lukea uudelleenohjauksen saraketta, koska se on helpoin arvioida, ja rakentaa toinen tuote.

Näyttämänne hinta ei ole vielä veloittamanne hinta

Ottakaa toinen tuote ja seuratkaa yhtä hintaa sen läpi. Haku palauttaa hinnan. Kävijä katsoo sitä, miettii, avaa toisen välilehden ja palaa. Jonkin ajan kuluttua hän painaa painiketta. Haun ja painikkeen välillä hinta on maannut järjestelmässänne, ja ainoa rehellinen kysymys mistä tahansa API:sta on, mitä se sanoo, kun kysytte uudelleen juuri sillä hetkellä.

Toimittaja voi antaa kolme vastausta. Se voi vahvistaa näyttämänne hinnan. Se voi palauttaa uuden hinnan, jolloin koodinne on päätettävä, veloittaako se erotuksen, kysyykö asiakkaalta vai pysähtyykö. Tai se voi sanoa, että hinta on poissa. Sivusto, joka on varautunut vain ensimmäiseen vastaukseen, toimii jokaisessa demossa ja pettää seuraavina viikkoina, ja se pettää tavalla, joka maksaa rahaa eikä heitä virheitä.

Suunnittelukysymys ei siis ole, onko API:ssa hinnan vahvistusvaihetta. Lähes kaikissa on. Kysymys on, miltä vastaus näyttää kaikissa kolmessa lopputuloksessa ja pystyykö koodinne erottamaan ne arvaamatta. Pyytäkää esimerkki kustakin. Toimittaja, joka näyttää toisen ja kolmannen dokumentaatiossaan, on miettinyt teidän tuotettanne. Toimittaja, joka näyttää vain ensimmäisen, on miettinyt demoa.

Iltapäivän testi, jota mikään taulukko ei anna

Lyhyestä listasta riippumatta ajakaa sama lyhyt testi jokaiselle nimelle ja aiheuttakaa virheet tahallaan. Varatkaa jotain ja katsokaa, mitä varausobjekti säilyttää lipun kirjoittamisen jälkeen. Tarkistakaa saman reitin hinta kahdesti muutaman minuutin välein ja katsokaa, miten toinen vastaus suhtautuu ensimmäiseen. Peruuttakaa, pyytäkää sitten hyvitystä ja kirjatkaa, kenen on toimittava. Esittäkää sitten toimittajalle kirjallisesti kaksi kysymystä: mitä järjestelmänne palauttaa, kun lentoyhtiö aikakatkaisee kesken varauksen, ja miten saan selville, mitä oikeasti tapahtui.

Kirjalliset vastaukset ovat arvokkaampia kuin demo. Toimittaja, jolla on selkeä menettely tuntemattomalle lopputulokselle, on kohdannut ongelman ennenkin. Toimittaja, joka vastaa ominaisuuden nimellä, ei ole.

Itse testisuunnitelman rakentamisesta kertoo sandbox-suunnitelma, myös siitä, mitä sandbox ei teille näytä. Ja jos punnitsette toimittajia sen mukaan, mitä API:n takana on, eikä itse API:n, se on erillinen kysymys omalla artikkelillaan; tämä pysyy tuotteessa.

Mitä maksatte, jos valitsette endpoint-listan perusteella

Viat ovat hiljaisia. Sivusto vahvistaa hinnat myöhään, joten näytetyn ja todellisen hinnan erotus lähtee katteestanne, varaus kerrallaan. Varaus jää tuntemattomaan tilaan, vaikka asiakkaan kortti on jo veloitettu, ja jonkun on selvitettävä se käsin, yleensä sähköpostilla, yleensä viikonloppuna. Pelkkään hakuun kelpaavan sisällön varaan rakennettu työkalu osoittautuu sellaiseksi, josta henkilöstö ei voi kirjoittaa lippuja, ja projekti rakennetaan uudelleen toisen sisällön ympärille.

Mikään tästä ei näy rastitaulukossa. Kaikki näkyi yllä olevan taulukon ensimmäisessä sarakkeessa, ennen kuin riviäkään koodia oli kirjoitettu.

Oma asemamme on kapeampi kuin ranking antaisi meidän väittää. Tekravel tarjoaa API:t lennoille ja hotelleille, pääsy alkaa keskustelusta eikä itsepalveluavaimesta, palvelut kytketään päälle tenant kerrallaan ja toimittajasisältö tavoittaa tenantin toimittajaryhmien kautta. Se sopii toiseen ja kolmanteen tuotteeseen. Jos rakennatte ensimmäistä, ette ehkä tarvitse meitä lainkaan. Jos rakennatte jompaakumpaa muista, API-sivu on paikka aloittaa keskustelu.

Tekravelin toimitus

Matkailuteknologian osasto

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