Szálloda- és repülőjegy-foglalási API: egy út, két foglalás

A feladat így szól: "tegyük be a szállodát a repülős folyamatba, egy pénztár, egy végösszeg". Ésszerű kérés egy termékmenedzsertől, és egynapos munkának hangzik, hiszen repülőkeresés már van, fizetési oldal is van. Három héttel később a csapat azon vitatkozik, mi történjen, ha a légitársaság visszaigazol, a szálloda pedig nem. Egy szálloda- és repülőjegy-foglalási API nem egyetlen integráció kétféle eredménnyel. Két integráció, amely egy kosáron osztozik.
Minél hamarabb ismeri ezt be a kód, annál kevesebbet kell újraírni belőle. Ami következik, azt az integrációs útmutatók kihagyják: miben tér el a két fél, melyiket kell előbb véglegesíteni, és minek kell lennie egy útnak az adatmodellben.
A két fél nem egyformán viselkedik
Mindkettő JSON-ként jön vissza, árral és hivatkozással, így a vezetéken hasonlónak látszanak. Abban viszont nem hasonlók, hogy mit ígérnek, miután a hivatkozás már a kezedben van.
| Kérdés | Repülő | Szálloda |
|---|---|---|
| Mi van a kezedben foglalás után | Egy foglalás (PNR), ami még nem jegy | Egy visszaigazolás, ami általában már maga az eladott szolgáltatás |
| Meddig érvényes az ár | Amíg a díjat foglaláskor újra nem árazzák, ami eltérhet a keresésitől | Amíg a tarifa le nem jár, és a tarifa változhat az elérhetőség és a foglalás között |
| Mi igazolja vissza | A jegykiállítás, gyakran határidőhöz kötve | A szállító visszaigazolása, néha azonnal, néha függőben |
| Hogyan vonható vissza | Void, ha időben elkapod, különben visszatérítés a díjszabás szerint, gyakran kötbérrel | Lemondás a tarifa saját feltételei szerint, sok tarifán ingyenes egy határidőig |
| Mi változtatja meg későn az összeget | Díj, illetékek, néha a díj pénzneme | A helyszínen fizetendő adók és díjak, az ellátás, a ténylegesen kiadott szoba |
Egy sorral vitatkozhatsz, hiszen a szállítók különböznek, de a formával nem: az egyik félnek van jegykiállítási lépése, a másiknak lemondási ablaka, és ezek időben nem esnek egybe. A sorozat repülős oldalát a repülőjegy-foglalási API integrációja cikkben tárgyaltuk, a lassú szállítók problémáját a szállodai oldalon pedig a szállodai elérhetőségi API kliensének tervezése írásban. Ez a cikk ott kezdődik, ahol azok véget érnek: az illesztésnél.
Melyiket foglalod előbb?
Senki nem mondja meg, hogy ez tervezési döntés, pedig ez határozza meg, mennyibe kerül egy hiba.
Tegyük fel, hogy egy ügyfél repülőt és szállodát vesz ugyanarra az időszakra. Elküldöd az egyik foglalást, aztán a másikat. Három dolog történhet: mindkettő sikerül, vagy az egyik elbukik, vagy az egyik azután bukik el, hogy a másik már sikerült. Az első egy jó nap. A másik kettő dönti el a support-sorodat.
Ha előbb a repülőjegyet állítod ki, és a szálloda utána elutasít, van egy ügyfeled, akinek ülése van egy városba, de szobája nincs, már megterhelték, és egy kötbéres jegy visszatérítése vár rád. Ha előbb a szállodát foglalod, és utána a repülő bukik el, egy olyan szobát tartasz, amelyet gyakran ingyen lemondhatsz, tehát a javítás olcsó. A fordított kockázat is valós, mert egy nem lemondható szállodai tarifa a rosszabb, amit a kezedben tarthatsz, ezért olvasd el a tarifa lemondási feltételeit, mielőtt elsőként engeded.
Ez ökölszabály, nem törvény, és a lényeg, hogy a sorrendet szándékosan válaszd. Előbb azt a felet véglegesítsd, amelyet könnyebb visszavonni, ellenőrizd mindkét árat közvetlenül azelőtt, hogy bármelyik véglegesedne, és írd le, mit teszel a három kimenet mindegyikénél. A kódáttekintők ritkán kérdezik. Az ügyfelek mindig rájönnek.
Egy út, két foglalás
A tartós forma egy út rekord, amely két foglalást birtokol, mindegyiket saját hivatkozással, saját státusszal és saját feltételekkel. Az ügyfél egy végösszeget lát. Az adatbázis két sort lát, és a végösszeg egy általad számolt összeg, nem valami, ami a szállítónál létezik.
Tartsd külön a két státuszt. A szálloda "visszaigazolt" és a repülő "kiállított" állapota nem ugyanaz, és egyetlen státuszoszlop, amely összemossa őket, előbb-utóbb "lefoglalva" feliratot tesz egy félig foglalt útra.
A két módosítási feltételrendszert is tartsd külön, és mutasd meg őket. Egy kijelzett végösszeg elrejti, hogy a dátumok áthelyezése az egyik félen ingyenes, a másikon díjas. Ha a frontend a "dátumok módosítása" funkciót egyetlen gombként mutatja, döntsd el, mit csinál, ha csak az egyik fél mozdítható, mielőtt egy ügyfél kideríti helyetted. Ugyanez igaz a felárra: ha szolgáltatásonként adod hozzá, ahogy a legtöbb eladó teszi, az út végösszege két felár, és az egyik fél visszatérítésének tudnia kell, melyik felárat adja vissza. A pénz az, ahol egy összekapcsolt út drágává válik, mert a tételek eltérő ütemezéssel számolódnak el, és egy repülőjegy visszatérítése nem akkor érkezik, amikor a szálloda lemondása.
Hol áll ez a platform
Egyenesen: a platform repülős és szállodai API-kat kínál, és a hozzáférés beszélgetéssel indul, nem önkiszolgáló kulccsal. A szolgáltatások tenantonként kapcsolhatók be, így egy tenant, amely szállodát árul, túrát nem, nem hordozza a túrás felületet. Semmi nem ígér itt egyetlen hívást, amely atomikusan foglalja mindkét felet, és ne is tervezz úgy, mintha ígérné. Kezeld őket annak, amik: két foglalásnak egy általad birtokolt út alatt.
Ha látni szeretnéd a tényleges hívásokat és feltételeket, mielőtt köréjük építesz, kezdd az utazási API-k oldalán, és hozd magaddal a tervezett foglalási sorrendet. Ha még azon gondolkodsz, mit ad az ingyenes hozzáférés, az ingyenes szállodafoglalási API cikk sorra veszi az ingyenesség fajtáit.
Mibe kerül, ha elrontod
A drága változat a csendes. Az ügyfélnek jegye van egy városba, a szoba eltűnt, és erről először egy éjszakai üzenetből értesülsz, egy repülőtérről. Olcsóbb, de szintén valós: egy pénztár, amely egy megnyugtató végösszeget mutat, majd egy árellenőrzés után egy második számot, amelybe az ügyfél nem egyezett bele; egy visszatérítés, amely visszaadja a repülőt és elfelejti a szállodát; és egy státusz, amely "lefoglalva" szól, miközben a szállító mást mond.
Ehhez nem kell okos megoldás. Az kell, hogy az út valódi objektum legyen, a sorrend olyan döntés, amelyet valaki leírt, és hogy mindkét árat az utolsó pillanatban újra ellenőrizd, mielőtt bármelyik véglegesedik. Építsd meg egyszer, és a pénztár olyan egyszerűnek látszhat, amilyet a feladat kért.