API za cijene letova: zašto prikazani iznos još nije tarifa

Demo radi. Programer spoji API za cijene letova u kalendar najjeftinijih dana za putovanje, tablica se popuni brojevima i svi u prostoriji su zadovoljni. Zatim prvi pravi kupac odabere datum, na stranici rezultata vidi manji iznos nego na stranici plaćanja i podršci pošalje snimku zaslona. Ništa nije pokvareno. API je učinio točno ono što je traženo: odgovorio je na pitanje o cijeni, a web-mjesto je taj odgovor shvatilo kao obećanje.
Cijena je ponuda s kratkim pamćenjem
Cijena zrakoplovne karte nije fiksna naljepnica na sjedalu. To je razred koji se otvara i zatvara kako se sjedala prodaju, a iznos uz njega mijenja se sa sastavom putnika, točnim letovima, porezima zračnih luka i valutom u kojoj je ponuda izražena. Odgovor o cijeni je snimka toga, napravljena u jednom trenutku za jedan skup ulaznih podataka. Ako ga tretirate kao činjenicu o prošlosti, izgradit ćete pravu stvar; ako ga tretirate kao činjenicu o sadašnjosti, mjesec dana ćete rješavati povrate novca.
Zato programeru nije korisno pitanje samo kolika je cijena. Korisno je pitanje kakva je to cijena, koliko je stara i što će sustav učiniti ako se pokaže pogrešnom.
Tri broja koja se zovu cijena
Većina davatelja u dokumentaciji vraća sva tri, često pod istim nazivom polja. Držite ih odvojeno u vlastitom podatkovnom modelu od prvog dana.
| Stanje | Odakle dolazi | Koliko je svježe | Smije li se prodati? | Što prikazati |
|---|---|---|---|---|
| Cijena za pregled | Pretraga iz predmemorije ili agregirana, građena za brzinu i širinu | Moguće zastarjela i nije izračunata za vaše putnike | Ne | Oznaka „od” i napomena da se može promijeniti |
| Ponuda s izračunatom cijenom | Živ upit za točan itinerar, vrste putnika i tarifu | Svježa u trenutku poziva, s rokom valjanosti ili signalom za ponovni izračun | Da, do isteka | Ukupni iznos, porezi navedeni zasebno, pravila tarife |
| Iznos izdane karte | Ono što je zrakoplovna kompanija ili sustav izdavanja stvarno naplatio pri narudžbi | Konačna | Već prodana | Račun; uskladite ga s ponudom |
Cijena za pregled omogućuje kalendare i oznake „najjeftinije od”, i to je sasvim dobra stvar za izgraditi. Samo nije isti objekt kao drugi redak. Greška je jedno polje price u koje utječu sva tri.
U praksi to znači tri odvojena tipa ili tablice u kodu, a ne jedan s oznakom. Cijena za pregled smije biti netočna u sitnicama jer je samo poziv na klik. Ponuda s izračunatom cijenom obveza je koju preuzimate u svoje ime, pa se pohranjuje s vremenom dohvaćanja, ulazima koji su je dali i identifikatorom koji će davatelj tražiti pri narudžbi. Iznos izdane karte je računovodstvo. Kad podrška pita zašto je kupac platio drugačiji broj od onog u e-poruci, odgovor je u razlici među recima, a nju možete pročitati samo ako ste sačuvali sva tri.
Što odgovor o cijeni mora nositi
Na golom broju ne može se graditi naplata. Kad čitate primjer odgovora davatelja, tražite sljedeće i budite sumnjičavi prema svemu što stiže kao slobodan tekst.
- Valuta, navedena u odgovoru, a ne pretpostavljena iz vašeg računa.
- Osnovna tarifa i porezi zasebno, da možete prikazati raščlambu i da promjena poreza ne izgleda kao promjena tarife.
- Vrste putnika za koje je cijena izračunata. Cijena za odraslog pomnožena s tri nije obiteljska tarifa.
- Pravila tarife i prtljaga kao strukturirani podaci, jer o njima ovisi je li jeftinija opcija doista jeftinija za vašeg kupca.
- Rok valjanosti ili signal za ponovni izračun: vremenska oznaka ili izričita tvrdnja da morate ponovno izračunati prije narudžbe.
Posljednju stavku ljudi preskaču. Ako vam ništa u odgovoru ne kaže koliko ponuda traje, nagađate, a nagađanje se događa u produkciji.
Ponovni izračun prije narudžbe, ne poslije
Najsigurniji ritam ima pravilo u sebi. Pretražujte za pregled. Kad kupac odabere itinerar, zatražite živu ponudu s izračunatom cijenom točno za taj itinerar i te putnike. Pokažite kupcu taj ukupni iznos. Tek tada kreirajte narudžbu. Ako se živa cijena razlikuje od one na stranici rezultata, kupcu to kažete prije plaćanja, jasnim riječima, a ne nakon što je platio.
Preskočite li srednji korak, nasljeđujete razliku. Ili naplatite više nego što je kupac vidio pa izgubite prodaju na stranici plaćanja, ili poštujete nižu cijenu pa razlika ide iz vaše marže. Mala agencija to može apsorbirati nekoliko puta, ali ne kao dizajn.
Pitajte ovo pisanim putem prije integracije
Dokumentacija opisuje sretan put. Ponašanje koje vas košta novca krije se u odgovorima na kratak popis pitanja, a te odgovore bolje je imati u e-poruci nego u razgovoru.
- Je li cijena u odgovoru pretrage živa ili iz predmemorije, i piše li to na samom odgovoru?
- Postoji li zaseban poziv za cijenu točnog itinerara i je li obavezan prije narudžbe?
- Što se događa pri narudžbi ako se cijena pomaknula: odbijanje, nova cijena u odgovoru ili tiha karta po novom iznosu?
- Kako se navode porezi i dodatne naknade prijevoznika i mogu li se promijeniti između izračuna cijene i izdavanja?
- U kojoj je valuti cijena izračunata i gdje se događa pretvorba ako kupac vidi drugu?
- Koliko dugo ponuda s izračunatom cijenom vrijedi i kako ćete to znati?
Davatelj koji precizno odgovori na ovo promislio je o naplati. Onaj koji odgovori „uvijek je ažurno” nije vam rekao ništa što možete testirati. Ako ponašanje ne možete sami isprobati, to je razlog da prije ulaganja u gradnju oko njega drugačije pogledati cijeli sustav.
Što košta pogreška
Rijetko puca glasno. Puca kao mali pad na koraku plaćanja koji nitko ne pripisuje cijeni, kao tiketi podrške koji počinju s „cijena se promijenila”, kao kupac koji je vjerovao stranici rezultata i sada više ne vjeruje. Osoblje na kraju ručno ponovno potvrđuje tarife prije izdavanja. Netko naposljetku predloži pravilo koje zaokružuje cijene prema gore radi sigurnosti, pa stranica postaje skupa na jedinom zaslonu na kojem se ljudi uspoređuju. Svako od toga porez je na odluku koja je na početku bila jeftina za ispravno donijeti.
Gdje je ova platforma
Platforma nudi API-je za letove i hotele, aktivirane po zakupcu. Pristup počinje razgovorom, a ne samoposlužnim ključem, pa nema obrasca za prijavu koji vam daje token i tablicu ograničenja. Ova stranica ne objavljuje latenciju, pokrivenost ni broj tarifa jer broj koji vam ne možemo pokazati kako testirati nije vrijedan ispisa. Možete donijeti gornja pitanja na taj razgovor i zatražiti da vidite odgovor za ponudu s izračunatom cijenom, a ne samo za pretragu. Ako ste u toj fazi, stranica o API-jima za putovanja je mjesto gdje sve počinje.