API за резервации на хотели и полети: едно пътуване, две резервации

Задачата гласи: "добавете хотели към потока за полети, една каса, една обща сума". Разумно искане от продуктов мениджър и звучи като работа за един ден, защото вече имате търсене на полети и вече имате страница за плащане. Три седмици по-късно екипът спори какво трябва да стане, когато авиокомпанията потвърди, а хотелът не. API за резервации на хотели и полети не е една интеграция с два вида резултат. Това са две интеграции, които делят една кошница.
Колкото по-рано кодът го признае, толкова по-малко от него ще се пренаписва. Следва онова, което ръководствата за интеграция пропускат: как се различават двете половини, коя да се потвърди първа и какво трябва да бъде пътуването във вашия модел на данни.
Двете половини не се държат еднакво
И двете се връщат като JSON с цена и референция, така че по кабела изглеждат еднакво. Не са еднакви обаче в това, което ви обещават, след като вече имате референцията.
| Въпрос | Полет | Хотел |
|---|---|---|
| Какво държите след резервацията | Резервация (PNR), която още не е билет | Потвърждение, което обикновено вече е продаденото |
| Колко време важи цената | Докато тарифата не се преизчисли при резервация, а тя може да се различава от търсенето | Докато тарифата не изтече, а тя може да се промени между наличността и резервацията |
| Какво я потвърждава | Издаването на билет, често срещу краен срок | Потвърждението на доставчика, понякога моментално, понякога чакащо |
| Как се отменя | Void, ако се хване рано, иначе възстановяване по тарифните правила, често с неустойка | Анулиране по собствените условия на тарифата, безплатно до краен срок при много тарифи |
| Какво променя сумата късно | Тарифа, такси, понякога валутата на тарифата | Данъци и такси, платени в обекта, режимът на хранене, реално предоставената стая |
Може да не сте съгласни с някой ред, защото доставчиците се различават, но не и с формата: едната половина има стъпка на издаване, а другата има прозорец за анулиране, и те не съвпадат във времето. Страната на полетите разгледахме в интеграция на API за резервации на полети, а проблема с бавните доставчици при хотелите в дизайн на клиент за API за наличност на хотели. Този текст започва там, където те свършват, на шева.
Коя резервирате първа?
Никой не ви казва, че това е дизайнерско решение, а точно то определя колко струва една грешка.
Да кажем, че клиент купува полет и хотел за едни и същи дати. Изпращате едната резервация, после другата. Могат да станат три неща: и двете успяват, или едната се проваля, или едната се проваля, след като другата е успяла. Първото е добър ден. Другите две определят опашката ви в поддръжката.
Ако първо издадете билета и хотелът после откаже, имате клиент с място до един град и без стая, който вече е таксуван, и възстановяване на билет с неустойка. Ако първо резервирате хотела и полетът после се провали, държите стая, която често можете да анулирате безплатно, така че поправката е евтина. Обратният риск също е реален, защото хотелска тарифа без право на анулиране е по-лошото нещо за държане, затова прочетете условията за анулиране на тарифата, преди да я пуснете първа.
Това е практическо правило, не закон, а смисълът е да изберете реда съзнателно. Потвърдете половината, която се отменя по-лесно, преди по-трудната, проверете цената и на двете точно преди която и да е да се потвърди, и запишете какво правите при всеки от трите изхода. Ревюърите рядко питат. Клиентите винаги разбират.
Едно пътуване, две резервации
Формата, която издържа, е запис за пътуване, който притежава две резервации, всяка със своя референция, свой статус и свои условия. Клиентът вижда една обща сума. Базата данни вижда два реда, а общата сума е сбор, който изчислявате, не нещо, което съществува при доставчика.
Дръжте двата статуса отделно. "Потвърдена" за хотела и "издаден" за полета не са едно и също състояние, а една колона за статус, която ги слива, рано или късно ще напише "резервирано" над наполовина резервирано пътуване.
Дръжте отделно и двата набора условия за промяна, и ги показвайте. Показаната обща сума крие, че преместването на датите е безплатна промяна за едната половина и такса за другата. Ако фронтендът показва "смяна на датите" като един бутон, решете какво прави той, когато само едната половина може да се премести, преди клиент да го открие вместо вас. Същото важи и за надценката: ако добавяте своята за всяка услуга, както правят повечето продавачи, общата сума на пътуването е две надценки, а възстановяването за едната половина трябва да знае коя надценка връща. Парите са мястото, където съвместното пътуване става скъпо, защото редовете се уреждат по различни графици, а възстановяването за полет не пристига, когато пристига анулирането на хотела.
Къде стои тази платформа
Направо: платформата предлага API за полети и хотели, а достъпът започва с разговор, не със самообслужващ се ключ. Услугите се включват за всеки tenant поотделно, така че tenant, който продава хотели, но не и турове, не носи повърхността за турове. Нищо тук не обещава едно извикване, което резервира двете половини атомарно, и не бива да проектирате, сякаш го прави. Третирайте ги като двете резервации, които са, под пътуване, което притежавате.
Ако искате да видите реалните извиквания и условия, преди да градите около тях, започнете от страницата за туристически API и донесете реда, в който смятате да резервирате. Ако още решавате какво ви дава безплатният достъп, безплатен API за резервации на хотели подрежда видовете безплатно.
Колко струва грешката
Скъпата версия е тихата. Клиент има билет до един град, стаята я няма, и първото, което научавате, е съобщение през нощта, от летище. По-евтино, но пак реално: каса, която показва една успокояваща обща сума, а след проверка на цената второ число, с което клиентът не се е съгласил; възстановяване, което връща полета и забравя хотела; и статус "резервирано", докато доставчикът казва друго.
Нищо от това не изисква хитро решение. Изисква пътуването да е истински обект, редът да е решение, което някой е записал, и повторна проверка на двете цени в последния момент, преди която и да е да се потвърди. Изградете го веднъж и касата може да изглежда толкова проста, колкото е поискала задачата.