Siirry sisältöön
Blogi

Lentovarausten API-integraatio: se, mistä dokumentaatio vaikenee

Tekravelin toimitus
Kirjoitettu tekoälyn avulla

Taululla oleva tiketti sanoo ”lisää lennot”. Olette jo toimittaneet maksuintegraation, toimituskuluintegraation, ehkä karttaintegraationkin, ja mukananne tuoma ajatusmalli on se ilmeisin: hae, näytä tulokset, veloita kortti, valmis. Sitten ensimmäinen oikea varaus palaa eri hinnalla kuin tulossivulla, toinen aikakatkeaa eikä kukaan osaa sanoa, onko asiakkaalla paikkaa, ja joku operatiivisesta puolesta kysyy, miksi varaus on olemassa mutta lippua ei. Lentovarausten API-integraatio näyttää ulkoa verkkokaupan kassalta. Pinnan alla se on hajautettu transaktio järjestelmiä vasten, jotka suunniteltiin kauan ennen RESTiä, ja useimmat yllätykset syntyvät juuri tästä raosta.

Teksti on kirjoitettu kehittäjälle, joka ei ole koskaan nähnyt PNR:ää. Se ei käsittele minkään yksittäisen toimittajan endpointteja; nimet vaihtuvat tarjoajalta toiselle, muoto ei.

Kutsuketju lentovarausten API-integraation takana

Lähes jokainen lento-API, kutsuipa se metodejaan miksi tahansa, kulkee samat neljä askelta. Niiden välisten rajojen vetäminen oikein on suurin osa työstä.

AskelMitä se antaaMitä teidän on tallennettavaMikä menee pieleen
HakuReittejä hinnalla ja läpinäkymättömällä tarjous- tai hinta-avaimellaEi mitään pysyvää — tulokset vanhenevat nopeastiPidätte hintaa lopullisena; avain vanhenee ennen kassaa
Hinnoittelu / varmistusVahvistetun hinnan, hintasäännöt, matkatavarat, joskus pakolliset matkustajakentätVarmistetun tarjouksen ja sen vanhenemisajanHinta muuttui; luokka myytiin loppuun; säännöt poikkeavat näyttämästänne
VarausVarauksen — PNR:n — record locatorilla ja lipunkirjoituksen määräajallaOman viitteenne, locatorin, määräajan, täsmälleen lähettämänne matkustajatiedotAikakatkaisu ilman vastausta; kaksoiskappale-PNR:t; hylätyt nimet
LipunkirjoitusKirjoitetut e-lipun numerot; tässä raha sitoutuu oikeastiJokaisen lipunnumeron, kytkettynä matkustajaan ja segmenttiin, joihin se kuuluuOsittainen kirjoitus; lentoyhtiö perui varauksen, koska määräaika umpeutui

Rivi, josta väitellään, on kolmas, koska monet API:t antavat varata ja kirjoittaa lipun yhdellä kutsulla. Käyttäkää sitä jos haluatte. Lentoyhtiön maailmassa ne ovat silti kaksi eri asiaa: PNR voi olla olemassa ilman lippua, ja lipunkirjoitus voi epäonnistua PNR:n luomisen jälkeen. Yhdistetty endpoint vain piilottaa hetken, jolloin toinen onnistui ja toinen ei, joten tietomallissanne on silti oltava paikka sille tilalle.

Huomatkaa myös, mitä haku ei palauta: lupausta. Se on mainos. Hinnoitteluaskel on tarjous, ja vasta lippu on kauppa.

Miksi hakemanne hinta ei ole varaamanne hinta

Web-kehittäjä odottaa katalogia. Lentoyhtiöiden varasto ei ole sellainen. Lento myydään varausluokissa, joista jokainen on ämpärillinen paikkoja tiettyyn hintaan, ja lentoyhtiö avaa ja sulkee ämpäreitä jatkuvasti koneen täyttyessä. Hakutulokset kootaan nopeasti saatavuudesta, joka saattaa olla jo hieman jäljessä; siihen mennessä kun käyttäjä on näpytellyt kaksi passia, sen lennon halvin ämpäri on voinut sulkeutua. Kun hinnoitteluaskel ajetaan, se kysyy uudelleen, ja rehellinen vastaus on joskus korkeampi.

Verot tuovat oman liukumansa. Ne lasketaan hinnoittelussa uudelleen juuri näille matkustajille ja tälle reitille, ja lapsi tai sylivauva hinnoitellaan eri tavalla kuin aikuinen, jonka haku oletti. Valuuttamuunnos, jos verkkokauppanne näyttää euroja toimittajan hinnoitellessa muussa valuutassa, on vielä yksi kohta, jossa luku liikkuu.

Suunnitteluseuraus on yksinkertainen ja usein ohitettu: älkää koskaan veloittako hakuhintaa. Ajakaa hinnoitteluaskel ennen maksua, verratkaa, ja jos summa muuttui, näyttäkää uusi luku ja kysykää. Mikä tahansa kate, jonka lisäätte, on laskettava uudelleen uudelleenhinnoitellun hinnan päälle, ei siirrettävä tulossivulta — logiikka on sama, jonka matkatoimisto käy läpi katestrategiaa verkossa asettaessaan, ja se rikkoutuu samalla tavalla, kun pohja liikkuu sen alla.

Idempotenssi ja mitä aikakatkaisu kesken varauksen tarkoittaa

Tämä on se osio, joka kannattaa lukea kahdesti.

Kun varauskutsu aikakatkeaa, ette tiedä mitä tapahtui. Pyyntö ei ehkä koskaan saapunut perille. Se on voinut saapua ja epäonnistua. Tai — se tapaus joka sattuu — se saapui, toimittaja loi PNR:n lentoyhtiöön, ja vastaus katosi matkalla takaisin teille. Koodillenne kaikki kolme näyttävät täsmälleen samalta. Lentoyhtiölle kolmas on elävä varaus, joka pitää paikkoja asiakkaanne nimellä.

Muista integraatioista tuttu refleksi on yrittää uudelleen. Täällä sokea uusintayritys voi tuottaa toisen PNR:n samoille matkustajille samalle lennolle. Lentoyhtiöt pitävät kaksoisvarauksia sääntörikkomuksena; lentoyhtiöstä ja toimiston sopimuksista riippuen seuraus vaihtelee toisen tai molempien varausten automaattisesta perumisesta veloitusilmoitukseen — ADM:ään — joka lähetetään sille, joka ne kirjoitti. Sen vastaanottava toimisto haluaa tietää, miksi järjestelmänne varasi kahdesti.

Mikä toimii, suunnilleen tässä järjestyksessä:

  • Luokaa oma varausviitteenne ennen ulospäin kutsumista, tallentakaa se ja lähettäkää se pyynnön mukana kaikkialla, missä API hyväksyy asiakasviitteen. Jos API tukee idempotency key -avainta, käyttäkää sitä; jos ei, viitteenne on silti se, jolla varauksen voi etsiä jälkikäteen.
  • Mallintakaa tuntematon tila eksplisiittisesti. Odottaa, vahvistettu, epäonnistunut — ja tuntematon. Aikakatkaisu siirtää varauksen tuntemattomaan, ei epäonnistuneeseen.
  • Ratkaiskaa tuntematon kysymällä, ei toistamalla. Hakekaa viitteellänne tai listatkaa viimeaikaiset varaukset näille matkustajille ennen kuin päätätte, yritättekö uudelleen.
  • Ajakaa täsmäytysajo, joka käy läpi kaiken yhä tuntemattoman, vertaa sitä toimittajan raportoimaan ja ohjaa sen, mitä se ei pysty ratkaisemaan, ihmisen jonoon arvaamisen sijaan.

Lipunkirjoituksen aikakatkaisut ovat sama ongelma rahalla höystettynä. Jos veloitatte kortin ennen lipunkirjoitusta ja kirjoitus jää jumiin, teillä on maksanut asiakas ja mahdollisesti ei lippua. Jos kirjoitatte lipun ennen veloitusta ja veloitus epäonnistuu, olette kirjoittaneet asiakirjan, jonka joku joutuu maksamaan lentoyhtiölle. Kortin varmennus ensin, sitten lipunkirjoitus, sitten veloitus onnistuessa on tavallinen muoto — pointti on päättää se tietoisesti, ei löytää sitä tuotannossa.

Matkailualan käsitteet, jotka yllättävät web-kehittäjät

Yksikään niistä ei ole vaikea. Jokainen on maksanut jollekin viikon, koska hän ei tiennyt sen olemassaolosta.

PNR ei ole lippu

PNR on varaustietue: matkustajat, segmentit, yhteystiedot, määräaika. Lippu on maksettu asiakirja, joka oikeuttaa matkustajan lentämään. Kirjoittamaton PNR vanhenee lipunkirjoituksen määräajassa ja paikat palaavat myyntiin, joskus teidän näkökulmastanne täysin hiljaa.

Nimet ovat lähes muuttumattomia

Lipunkirjoituksen jälkeen useimmat hinnat eivät salli nimenmuutosta pientä korjausta lukuun ottamatta, ja se, mikä lasketaan pieneksi, vaihtelee lentoyhtiöittäin. Nimen on vastattava matkustusasiakirjaa. Kerätkää sukunimi ja etunimet erikseen, älkää antako vapaamuotoisen tittelin vuotaa nimikenttään, ja validoikaa ennen varauskutsua, ei sen jälkeen.

Matkustajatyypit hinnoitellaan, ne eivät ole koristeita

Aikuinen, lapsi ja sylivauva ovat hintatyyppejä, ja ikä, joka ratkaisee kumpi pätee, on yleensä ikä matkustuspäivänä, ei varauspäivänä. Sylivauva ei tyypillisesti vie paikkaa ja saa usein matkustaa vain aikuisen kanssa. Väärä tyyppi tarkoittaa, että hinnoittelu joko epäonnistuu tai tarjoaa väärän hinnan.

Ajat ovat paikallisia, eivätkä segmentit ole osuuksia

Lähtö- ja saapumisajat annetaan kunkin lentoaseman paikallisessa ajassa. Älkää muuntako niitä käyttäjän aikavyöhykkeeseen näyttöä varten, älkääkä laskeko kestoja vähentämällä niitä toisistaan ilman aikaeroja. Matka sisältää segmenttejä; segmentti, jossa on tekninen välilasku, sisältää useamman kuin yhden osuuden. Käyttöliittymänne ja datanne on oltava samaa mieltä siitä, kumpi näistä on ”välilasku”.

Asioita tapahtuu kaupan jälkeen

Lentoyhtiöt muuttavat aikatauluja lippujen kirjoittamisen jälkeen. Varaus, joka oli oikein lipunkirjoituksessa, voi viikkoja myöhemmin näyttää uuden ajan, uuden lennon numeron tai katkenneen jatkoyhteyden, ja toimittajasta riippuen saatte tiedon ilmoituksella, jonon kautta tai hakemalla varauksen uudelleen. Suunnitelkaa sen varaan, että varaus muuttuu sen jälkeen, kun olette lakanneet katsomasta sitä.

Void ei ole hyvitys

Pian kirjoituksen jälkeen on yleensä ikkuna, jonka aikana lipun voi mitätöidä (void) ikään kuin sitä ei olisi koskaan ollut. Ikkunan jälkeen on mahdollinen vain hintasääntöjen mukainen hyvitys, joka voi maksaa sakon tai palauttaa ei mitään. Ikkuna ja sen säännöt kuuluvat toimittajalle ja lipunkirjoitussopimukselle; lukekaa ne ennen kuin rakennatte ”peru”-painikkeen.

Mitä virhe maksaa

Lentointegraation virheet ovat kalliita tietyllä tavalla: ne osuvat ihmisiin, eivät lokeihin. Kaksoisvarauksesta tulee puhelu lentoyhtiölle ja mahdollisesti ilmoitus toimiston tiliä vastaan. Veloitetusta asiakkaasta ilman lippua tulee hyvitys, valitus ja chargeback-riski. Ilman onnistunutta maksua kirjoitetusta lipusta tulee velka lentoyhtiölle, jonka joku joutuu selvittämään. Aikataulumuutoksesta, jota kukaan ei käsitellyt, tulee matkustaja lentoasemalla lennolle, joka lähti aiemmin.

Mikään näistä ei näy onnellisen polun testissä. Kirjoittakaa onnettomat polut ensin: aikakatkaisu varauksessa, noussut hinta, PNR:n jälkeen epäonnistunut lipunkirjoitus, void onnistuneen maksun jälkeen. Jos ne on hoidettu, onnellinen polku on se helppo osa.

Testaaminen lento-API:a vasten

Toimittajien testiympäristöt ovat hyödyllisiä ja puutteellisia. Ne ovat yleensä tuotantoa hiljaisempia, joten loppuunmyydyt luokat ja hinnanmuutokset ovat harvinaisempia, eivätkä jotkut simuloi aikakatkaisuja lainkaan. Käyttäkää niitä kutsujen muotoon ja validointivirheisiin, ja suunnitelkaa sitten hallittu ajo tuotannossa oikeilla varauksilla, jotka mitätöitte ikkunan sisällä — niin, että operatiivinen puoli tietää, että teette sen.

Se, kannattaako integroida lainkaan, on erillinen kysymys. Jos oikeasti tarvitsette verkkokaupan ettekä raakaa varastoa omaan järjestelmäänne, kompromissi on kuvattu artikkelissa white label vai oma varausjärjestelmä, ja sama päättely pätee B2B-portaaliin aliagenteille. Jos haluatte varaston omaan koodiinne, alusta tarjoaa lento- ja hotelli-API:t, ja pääsy alkaa keskustelulla käyttötapauksestanne eikä itsepalveluavaimella — mikä on myös oikea hetki esittää jokainen yllä olevista kysymyksistä.

Tekravelin toimitus

Matkailuteknologian osasto

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