API pro ceny letenek: proč zobrazené číslo ještě není tarif

Demo funguje. Vývojář připojí API pro ceny letenek do kalendáře nejlevnějších dnů k odletu, mřížka se zaplní čísly a všichni v místnosti jsou spokojení. Pak první skutečný zákazník vybere datum, na stránce s výsledky vidí nižší částku než na platební stránce a napíše podpoře se snímkem obrazovky. Nic není rozbité. API udělalo přesně to, oč bylo požádáno: odpovědělo na otázku o ceně, a web tuto odpověď považoval za slib.
Cena je nabídka s krátkou pamětí
Letecký tarif není pevný štítek přilepený na sedadle. Je to rezervační třída, která se otevírá a zavírá, jak se prodávají místa, a číslo k ní připojené se mění s tím, kdo cestuje, s konkrétními lety, s poplatky dotčených letišť i s měnou, ve které je nabídka vyjádřena. Odpověď s cenou je momentka pořízená v jednom okamžiku pro jednu sadu vstupů. Berete-li ji jako fakt o minulosti, postavíte správnou věc; berete-li ji jako fakt o přítomnosti, strávíte měsíc vracením peněz.
Užitečná otázka pro vývojáře tedy nikdy nezní jen, jaká je cena. Zní: o jaký druh ceny jde, jak je stará a co systém udělá, pokud se ukáže jako nesprávná.
Tři čísla, kterým se všem říká cena
Většina poskytovatelů vrací všechna tři někde ve své dokumentaci, často pod stejným názvem pole. Ve vlastním datovém modelu je držte oddělená od prvního dne.
| Stav | Odkud pochází | Jak čerstvá | Lze ji prodat? | Co ukázat |
|---|---|---|---|---|
| Cena z vyhledávání | Cachované nebo agregované hledání stavěné na rychlost a šíři | Možná zastaralá a nespočtená pro vaše cestující | Ne | Formulaci „od“ a upozornění, že se může změnit |
| Přeceněná nabídka | Živý dotaz na přesnou cestu, typy cestujících a tarif | Čerstvá v okamžiku volání, s expirací nebo signálem k přecenění | Ano, dokud nevyprší | Celkovou částku, rozepsané poplatky, podmínky tarifu |
| Vystavená částka | Co aerolinka nebo vystavující systém skutečně účtoval při objednávce | Konečná | Už prodáno | Doklad; srovnejte jej s nabídkou |
Cena z vyhledávání umožňuje kalendáře a štítky „nejlevněji od“ a je to dobrá věc k vybudování. Jen to není stejný objekt jako druhý řádek. Chybou je jediné pole price, do kterého tečou všechna tři.
V praxi to znamená tři oddělené typy nebo tabulky v kódu, ne jednu s příznakem. Cena z vyhledávání smí být v drobnostech nepřesná, protože je jen pobídkou ke kliknutí. Přeceněná nabídka je závazek, který hodláte učinit vlastním jménem, takže se ukládá s časem získání, se vstupy, které ji vytvořily, a s identifikátorem, který poskytovatel při objednávce vyžádá zpět. Vystavená částka je účetnictví. Když se podpora ptá, proč zákazník zaplatil jiné číslo než to z e-mailu, odpověď leží v rozdílu mezi řádky, a ten přečtete jen tehdy, pokud jste uchovali všechny tři.
Co musí odpověď s cenou obsahovat
Holé číslo nestačí na postavení pokladny. Když čtete ukázkovou odpověď poskytovatele, hledejte následující a buďte podezřívaví ke všemu, co přichází jako volný text.
- Měnu uvedenou přímo v odpovědi, ne domnělou z vašeho účtu.
- Základní tarif a poplatky zvlášť, abyste mohli ukázat rozpis a změna poplatků nevypadala jako změna tarifu.
- Typy cestujících, pro které byla cena spočtena. Cena dospělého krát tři není rodinný tarif.
- Podmínky tarifu a zavazadla jako strukturovaná data, protože rozhodují o tom, zda je levná varianta pro zákazníka opravdu levnější.
- Expiraci nebo signál k přecenění: časové razítko nebo výslovné prohlášení, že před objednávkou musíte přecenit.
Poslední bod lidé vynechávají. Pokud v odpovědi nic neříká, jak dlouho nabídka žije, hádáte, a hádá se v ostrém provozu.
Přeceňte před objednávkou, ne po ní
Nejbezpečnější rytmus obsahuje pravidlo. Hledání slouží k prohlížení. Když zákazník vybere cestu, vyžádáte si živou přeceněnou nabídku přesně pro tuto cestu a tyto cestující. Ukážete zákazníkovi tuto celkovou částku. Teprve poté vytvoříte objednávku. Liší-li se živá cena od té na stránce s výsledky, řeknete to zákazníkovi před zaplacením, jasnými slovy, ne až po něm.
Vynecháte-li prostřední krok, zdědíte rozdíl. Buď účtujete víc, než zákazník viděl, a přijdete o prodej na platební stránce, nebo uznáte nižší číslo a mezera jde z vaší marže. Malá agentura to několikrát vstřebá; jako návrh systému to vstřebat nedokáže.
Zeptejte se na tohle písemně, než začnete integrovat
Dokumentace popisuje šťastnou cestu. Chování, které stojí peníze, se skrývá v odpovědích na krátký seznam otázek a ty stojí za to mít v e-mailu, ne v hovoru.
- Je cena v odpovědi z vyhledávání živá, nebo z cache, a říká se to přímo v odpovědi?
- Existuje samostatné volání pro přecenění přesné cesty a je před objednávkou povinné?
- Co se stane při objednávce, pokud se cena pohnula: odmítnutí, nová cena v odpovědi, nebo tiché vystavení za novou částku?
- Jak jsou rozepsány poplatky a palivové příplatky dopravce a mohou se změnit mezi přeceněním a vystavením?
- V jaké měně se cena počítá a kde probíhá převod, vidí-li zákazník jinou?
- Jak dlouho platí přeceněná nabídka a jak se to dozvíte?
Poskytovatel, který na to odpoví přesně, o pokladně přemýšlel. Ten, kdo odpoví „je vždy aktuální“, vám neřekl nic, co byste mohli vyzkoušet. Pokud chování nemůžete vyzkoušet sami, je to důvod podívat se na celou sestavu jinak, než se rozhodnete stavět kolem ní.
Co stojí chyba v tomto místě
Málokdy selže nahlas. Selže jako malý propad na platebním kroku, který nikdo nepřičítá ceně, jako tikety podpory začínající „cena se změnila“, jako zákazník, který věřil stránce s výsledky a teď už nevěří. Zaměstnanci nakonec potvrzují tarify ručně před vystavením. Někdo nakonec navrhne pravidlo, které ceny pro jistotu zaokrouhluje nahoru, a web je drahý právě na obrazovce, kde lidé srovnávají. Každé z toho je daň z rozhodnutí, které bylo na začátku levné udělat správně.
Kde stojí tato platforma
Platforma nabízí API pro lety a hotely, aktivovaná pro každého tenanta zvlášť. Přístup začíná rozhovorem, ne samoobslužným klíčem, takže neexistuje registrační formulář, který by vám dal token a tabulku limitů. Tato stránka neuvádí latenci, pokrytí ani počty tarifů, protože číslo, u kterého vám neukážeme, jak ho ověřit, nestojí za vytištění. Můžete přinést výše uvedené otázky do onoho rozhovoru a požádat o ukázku odpovědi pro přeceněnou nabídku, nejen pro vyhledávání. Pokud jste v této fázi, stránka cestovních API je místo, kde to začíná.