API na rezervácie hotelov a leteniek: jedna cesta, dve rezervácie

Zadanie znie: "pridajte hotely do toku leteniek, jedna pokladnica, jedna celková suma". Rozumná požiadavka produktového manažéra a znie ako práca na jeden deň, pretože vyhľadávanie letov už máte a platobnú stránku tiež. O tri týždne sa tím háda o tom, čo sa má stať, keď letecká spoločnosť potvrdí a hotel nie. API na rezervácie hotelov a leteniek nie je jedna integrácia s dvoma druhmi výsledku. Sú to dve integrácie, ktoré zdieľajú jeden košík.
Čím skôr to kód prizná, tým menej z neho sa bude prepisovať. Nasleduje časť, ktorú integračné príručky preskakujú: v čom sa dve polovice líšia, ktorú potvrdiť ako prvú a čím musí byť cesta vo vašom dátovom modeli.
Dve polovice sa nesprávajú rovnako
Obe sa vracajú ako JSON s cenou a referenciou, takže na drôte vyzerajú podobne. Nie sú podobné v tom, čo vám sľubujú, keď už referenciu máte.
| Otázka | Let | Hotel |
|---|---|---|
| Čo držíte po rezervácii | Rezerváciu (PNR), ktorá ešte nie je letenka | Potvrdenie, ktoré je zvyčajne už tým, čo ste predali |
| Ako dlho platí cena | Kým sa tarifa pri rezervácii neprepočíta, a môže sa líšiť od vyhľadávania | Kým tarifa nevyprší, a tá sa môže zmeniť medzi dostupnosťou a rezerváciou |
| Čo ju potvrdzuje | Vystavenie letenky, často s časovým limitom | Potvrdenie dodávateľa, niekedy okamžité, niekedy čakajúce |
| Ako sa ruší | Void, ak sa to zachytí včas, inak refundácia podľa tarifných pravidiel, často s poplatkom | Storno podľa vlastných podmienok tarify, pri mnohých tarifách bezplatné do určitého termínu |
| Čo neskoro mení sumu | Tarifa, poplatky, niekedy mena tarify | Dane a poplatky platené v ubytovaní, typ stravy, skutočne pridelená izba |
S niektorým riadkom môžete nesúhlasiť, pretože dodávatelia sa líšia, ale nie s tvarom: jedna polovica má krok vystavenia, druhá má okno na storno, a v čase sa nezhodujú. Stranu letov sme rozobrali v článku integrácia API na rezervácie leteniek a problém pomalých dodávateľov na strane hotelov v článku návrh klienta pre API dostupnosti hotelov. Tento text začína tam, kde oni končia, v spoji.
Ktorú rezervujete ako prvú?
Nikto vám nepovie, že ide o návrhové rozhodnutie, a práve ono určuje, koľko stojí chyba.
Povedzme, že zákazník kupuje let a hotel na rovnaké dátumy. Pošlete jednu rezerváciu, potom druhú. Môžu sa stať tri veci: obe vyjdú, alebo jedna zlyhá, alebo jedna zlyhá potom, čo druhá už vyšla. Prvé je dobrý deň. Ďalšie dve určujú vaš rad na podpore.
Ak najprv vystavíte letenku a hotel potom odmietne, máte zákazníka so sedadlom do mesta a bez izby, ktorému už bola stiahnutá platba, a refundáciu letenky s poplatkom. Ak najprv rezervujete hotel a let potom zlyhá, držíte izbu, ktorú často môžete zrušiť zadarmo, takže oprava je lacná. Opačné riziko je tiež skutočné, lebo nevratná hotelová tarifa je horšia vec na držanie, preto si prečítajte storno podmienky tarify skôr, než ju pustíte ako prvú.
Je to pravidlo z praxe, nie zákon, a podstatou je zvoliť poradie zámerne. Potvrďte polovicu, ktorú je ľahšie zrušiť, pred tou, ktorú je ťažšie, overte cenu oboch tesne pred tým, než sa ktorákoľvek potvrdí, a zapíšte si, čo urobíte pri každom z troch výsledkov. Recenzenti sa pýtajú zriedka. Zákazníci na to prídu vždy.
Jedna cesta, dve rezervácie
Tvar, ktorý vydrží, je záznam cesty, ktorý vlastní dve rezervácie, každú s vlastnou referenciou, vlastným stavom a vlastnými podmienkami. Zákazník vidí jednu celkovú sumu. Databáza vidí dva riadky a celková suma je súčet, ktorý počítate vy, nie niečo, čo existuje u dodávateľa.
Držte dva stavy oddelene. "Potvrdené" pre hotel a "vystavené" pre let nie sú ten istý stav a jeden stĺpec stavu, ktorý ich zlúči, skôr či neskôr napíše "rezervované" nad napoly rezervovanú cestu.
Oddelene držte aj dve sady podmienok zmien a zobrazte ich. Zobrazená celková suma skrýva, že posun dátumov je na jednej polovici bezplatná úprava a na druhej poplatok. Ak frontend zobrazuje "zmeniť dátumy" ako jedno tlačidlo, rozhodnite, čo urobí, keď sa dá posunúť len jedna polovica, skôr než to za vás zistí zákazník. To isté platí pre maržu: ak ju pridávate za každú službu, ako to robí väčšina predajcov, celková suma cesty sú dve marže a refundácia jednej polovice musí vedieť, ktorú maržu vracia. Peniaze sú miesto, kde sa spojená cesta predraží, pretože položky sa vyúčtovávajú v rôznych časových rámcoch a refundácia letenky nepríde vtedy, keď príde storno hotela.
Kde stojí táto platforma
Priamo: platforma ponúka API pre lety a hotely a prístup sa začína rozhovorom, nie samoobslužným kľúčom. Služby sa zapínajú pre každý tenant zvlášť, takže tenant, ktorý predáva hotely a nie zájazdy, nenesie rozhranie pre zájazdy. Nič tu nesľubuje jedno volanie, ktoré atomicky rezervuje obe polovice, a nemali by ste navrhovať, akoby to tak bolo. Pristupujte k nim ako k dvom rezerváciám, ktorými sú, pod cestou, ktorú vlastníte vy.
Ak chcete vidieť skutočné volania a podmienky predtým, než okolo nich začnete stavať, začnite na stránke o cestovných API a prineste poradie, v ktorom chcete rezervovať. Ak sa ešte rozhodujete, čo vám dá bezplatný prístup, článok bezplatné API na rezervácie hotelov rozoberá druhy bezplatného.
Koľko stojí chyba
Drahá verzia je tá tichá. Zákazník má letenku do mesta, izba je preč, a prvé, čo sa dozviete, je správa v noci z letiska. Lacnejšie, ale stále skutočné: pokladnica, ktorá ukáže jednu upokojujúcu sumu a po kontrole ceny druhé číslo, s ktorým zákazník nesúhlasil; refundácia, ktorá vráti let a zabudne na hotel; a stav "rezervované", zatiaľ čo dodávateľ hovorí niečo iné.
Nič z toho nepotrebuje šikovné riešenie. Potrebuje to, aby cesta bola skutočný objekt, aby poradie bolo rozhodnutie, ktoré niekto zapísal, a opätovnú kontrolu oboch cien v poslednej chvíli pred tým, než sa ktorákoľvek potvrdí. Postavte to raz a pokladnica môže vyzerať tak jednoducho, ako žiadalo zadanie.