API za rezervacije hotela i letova: jedno putovanje, dvije rezervacije

Zadatak glasi: "dodajte hotele u tijek za letove, jedna blagajna, jedan ukupni iznos". Razuman zahtjev voditelja proizvoda, i zvuči kao posao za jedan dan, jer već imate pretragu letova i već imate stranicu za plaćanje. Tri tjedna kasnije tim se svađa oko toga što treba biti kad zrakoplovna tvrtka potvrdi, a hotel ne. API za rezervacije hotela i letova nije jedna integracija s dvije vrste rezultata. To su dvije integracije koje dijele jednu košaricu.
Što prije kod to prizna, manje će ga se morati prepisivati. Slijedi dio koji vodiči za integraciju preskaču: po čemu se dvije polovice razlikuju, koju prvu potvrditi i što putovanje mora biti u vašem podatkovnom modelu.
Dvije polovice se ne ponašaju jednako
Obje se vraćaju kao JSON s cijenom i referencom, pa na žici izgledaju slično. Nisu slične u onome što vam obećavaju nakon što referencu već imate.
| Pitanje | Let | Hotel |
|---|---|---|
| Što držite nakon rezervacije | Rezervaciju (PNR) koja još nije karta | Potvrdu koja je obično već ono što ste prodali |
| Koliko dugo vrijedi cijena | Dok se tarifa ne preračuna pri rezervaciji, a može se razlikovati od pretrage | Dok tarifa ne istekne, a tarifa se može promijeniti između raspoloživosti i rezervacije |
| Što je potvrđuje | Izdavanje karte, često uz rok | Potvrda dobavljača, ponekad odmah, ponekad na čekanju |
| Kako se poništava | Void ako se uhvati rano, inače povrat po tarifnim pravilima, često s penalom | Otkaz po uvjetima same tarife, besplatan do roka na mnogim tarifama |
| Što kasno mijenja iznos | Tarifa, pristojbe, ponekad valuta tarife | Porezi i naknade plaćeni u objektu, vrsta usluge, soba koja je stvarno dodijeljena |
Možete se ne složiti s nekim retkom, jer se dobavljači razlikuju, ali ne i s oblikom: jedna polovica ima korak izdavanja, druga ima prozor za otkaz, i oni se ne poklapaju u vremenu. Stranu letova obradili smo u tekstu integracija API-ja za rezervacije letova, a problem sporih dobavljača na strani hotela u tekstu dizajn klijenta za API raspoloživosti hotela. Ovaj tekst počinje tamo gdje oni završavaju, na spoju.
Koju rezervirate prvu?
Nitko vam ne kaže da je ovo dizajnerska odluka, a upravo ona određuje koliko pogreška košta.
Recimo da kupac kupuje let i hotel za iste datume. Šaljete jednu rezervaciju, pa drugu. Mogu se dogoditi tri stvari: obje uspiju, ili jedna ne uspije, ili jedna ne uspije nakon što je druga već uspjela. Prvo je dobar dan. Druge dvije određuju red u vašoj podršci.
Ako prvo izdate kartu, a hotel zatim odbije, imate kupca sa sjedalom do jednog grada i bez sobe, koji je već terećen, i povrat za kartu s penalom. Ako prvo rezervirate hotel, a let zatim ne uspije, držite sobu koju često možete besplatno otkazati, pa je popravak jeftin. I obrnuti rizik je stvaran, jer hotelska tarifa bez mogućnosti otkaza je gora stvar za držati, zato pročitajte uvjete otkaza tarife prije nego što je pustite prvu.
Ovo je pravilo iz iskustva, ne zakon, a poanta je da redoslijed odaberete namjerno. Potvrdite polovicu koju je lakše poništiti prije one koju je teže, provjerite cijenu obje neposredno prije nego što bilo koja bude potvrđena, i zapišite što radite za svaki od tri ishoda. Recenzenti rijetko pitaju. Kupci uvijek saznaju.
Jedno putovanje, dvije rezervacije
Oblik koji izdrži je zapis putovanja koji posjeduje dvije rezervacije, svaku sa svojom referencom, svojim statusom i svojim uvjetima. Kupac vidi jedan ukupni iznos. Baza vidi dva retka, a ukupni iznos je zbroj koji vi računate, ne nešto što postoji kod dobavljača.
Držite dva statusa odvojeno. "Potvrđeno" za hotel i "izdano" za let nisu isto stanje, a jedan stupac statusa koji ih spljošti reći će prije ili kasnije "rezervirano" za napola rezervirano putovanje.
Držite odvojeno i dva skupa uvjeta izmjene, i prikažite ih. Prikazani ukupni iznos skriva da je pomicanje datuma besplatna izmjena na jednoj polovici i naknada na drugoj. Ako frontend prikazuje "promijeni datume" kao jedan gumb, odlučite što radi kad se samo jedna polovica može pomaknuti, prije nego što to kupac otkrije umjesto vas. Isto vrijedi za maržu: ako je dodajete po usluzi, kao što radi većina prodavača, ukupni iznos putovanja su dvije marže, a povrat za jednu polovicu mora znati koju maržu vraća. Novac je mjesto gdje spojeno putovanje postaje skupo, jer se stavke namiruju po različitim rokovima, a povrat za let ne stiže kad stiže otkaz hotela.
Gdje stoji ova platforma
Otvoreno: platforma nudi API-je za letove i hotele, a pristup počinje razgovorom, ne ključem koji sami preuzimate. Usluge se uključuju po tenantu, pa tenant koji prodaje hotele, a ne ture, ne nosi površinu za ture. Ništa ovdje ne obećava jedan poziv koji atomski rezervira obje polovice, i ne biste trebali projektirati kao da obećava. Tretirajte ih kao dvije rezervacije, što i jesu, pod putovanjem koje vi posjedujete.
Ako želite vidjeti stvarne pozive i uvjete prije nego što gradite oko njih, počnite od stranice o turističkim API-jima i ponesite redoslijed kojim namjeravate rezervirati. Ako još odlučujete što vam besplatan pristup donosi, tekst besplatan API za rezervacije hotela redom navodi vrste besplatnog.
Koliko košta pogreška
Skupa verzija je tiha. Kupac ima kartu do jednog grada, sobe nema, i prvo što čujete je poruka noću, sa zračne luke. Jeftinije, ali i dalje stvarno: blagajna koja pokazuje jedan umirujući iznos, a zatim, nakon provjere cijene, drugi broj na koji kupac nije pristao; povrat koji vrati let i zaboravi hotel; i status "rezervirano" dok dobavljač kaže drukčije.
Ništa od toga ne traži pametno rješenje. Traži da putovanje bude pravi objekt, da redoslijed bude odluka koju je netko zapisao, i ponovnu provjeru obje cijene u posljednjem trenutku prije nego što bilo koja bude potvrđena. Izgradite to jednom i blagajna može izgledati jednostavno kao što je zadatak tražio.