Paras lentovaraus-API: kertokaa ensin, mitä rakennatte

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.
| Ominaisuus | Uudelleenohjaussivu | Myy ja ottaa maksun | Toimiston henkilöstön työkalu |
|---|---|---|---|
| Kuinka vanha näytetty hinta saa olla ennen vahvistusta | Merkitsee vähän | Ratkaiseva: veloitatte sen perusteella | Merkitsee, henkilöstö tarjoaa sen perusteella |
| Mitä varaus palauttaa, kun lentoyhtiö on hidas | Ei koske | Ratkaiseva | Merkitsee |
| Kuka voi mitätöidä ja hyvittää, ja miten sitä pyydetään | Ei koske | Ratkaiseva | Ratkaiseva |
| Miten varaus, jonka lopputulos on tuntematon, ratkaistaan | Ei koske | Ratkaiseva: kortti on ehkä jo veloitettu | Merkitsee |
| Pätevätkö toimiston oma sisältö ja luottosäännöt | Ei koske | Joskus | Ratkaiseva |
| Kuinka paljon testikäytös eroaa tuotannosta | Matala | Korkea | Korkea |
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.