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

Задатак гласи: "додајте хотеле у ток за летове, једна каса, један укупан износ". Разуман захтев продуктног менаџера, и звучи као посао за један дан, јер већ имате претрагу летова и већ имате страницу за плаћање. Три недеље касније тим се свађа око тога шта треба да се деси када авио-компанија потврди, а хотел не. API за резервације хотела и летова није једна интеграција са две врсте резултата. То су две интеграције које деле једну корпу.
Што пре код то призна, мање ће га се преписивати. Следи део који водичи за интеграцију прескачу: по чему се две половине разликују, коју прву потврдити и шта путовање мора да буде у вашем моделу података.
Две половине се не понашају исто
Обе се враћају као JSON са ценом и референцом, па на жици изгледају слично. Нису сличне у ономе што вам обећавају када референцу већ имате.
| Питање | Лет | Хотел |
|---|---|---|
| Шта држите после резервације | Резервацију (PNR) која још није карта | Потврду која је обично већ оно што сте продали |
| Колико важи цена | Док се тарифа не преобрачуна при резервацији, а може се разликовати од претраге | Док тарифа не истекне, а тарифа се може променити између расположивости и резервације |
| Шта је потврђује | Издавање карте, често уз рок | Потврда добављача, понекад одмах, понекад на чекању |
| Како се поништава | Void ако се ухвати рано, иначе повраћај по тарифним правилима, често са пеналом | Отказ по условима саме тарифе, бесплатан до рока на многим тарифама |
| Шта касно мења износ | Тарифа, таксе, понекад валута тарифе | Порези и накнаде који се плаћају у објекту, услуга исхране, соба која је стварно додељена |
Можете се не сложити са неким редом, јер се добављачи разликују, али не и са обликом: једна половина има корак издавања, друга има прозор за отказ, и они се не поклапају у времену. Страну летова покрили смо у тексту интеграција API-ја за резервације летова, а проблем спорих добављача на страни хотела у тексту дизајн клијента за API расположивости хотела. Овај текст почиње тамо где они завршавају, на споју.
Коју резервишете прву?
Нико вам не каже да је ово дизајнерска одлука, а управо она одређује колико кошта грешка.
Рецимо да купац купује лет и хотел за исте датуме. Шаљете једну резервацију, па другу. Могу да се десе три ствари: обе успеју, или једна не успе, или једна не успе пошто је друга већ успела. Прво је добар дан. Друге две одређују ред у вашој подршци.
Ако прво издате карту, а хотел затим одбије, имате купца са седиштем до једног града и без собе, који је већ задужен, и повраћај за карту са пеналом. Ако прво резервишете хотел, а лет затим не успе, држите собу коју често можете бесплатно да откажете, па је поправка јефтина. И обрнути ризик је стваран, јер хотелска тарифа без отказа је горе држати, зато прочитајте услове отказа тарифе пре него што је пустите прву.
Ово је правило из искуства, не закон, а поента је да редослед изаберете намерно. Потврдите половину коју је лакше поништити пре оне коју је теже, проверите цену обе непосредно пре него што било која буде потврђена, и запишите шта радите за сваки од три исхода. Рецензенти ретко питају. Купци увек сазнају.
Једно путовање, две резервације
Облик који издржава је запис путовања који поседује две резервације, свака са својом референцом, својим статусом и својим условима. Купац види један укупан износ. База види два реда, а укупан износ је збир који ви рачунате, не нешто што постоји код добављача.
Држите два статуса одвојено. "Потврђено" за хотел и "издато" за лет нису исто стање, а једна колона статуса која их спљошти рећи ће пре или касније "резервисано" за напола резервисано путовање.
Држите одвојено и два скупа услова измене, и прикажите их. Приказан укупан износ крије да је померање датума бесплатна измена на једној половини и накнада на другој. Ако фронтенд приказује "промени датуме" као једно дугме, одлучите шта ради када само једна половина може да се помери, пре него што то купац открије уместо вас. Исто важи за маржу: ако је додајете по услузи, као што ради већина продаваца, укупан износ путовања су две марже, а повраћај за једну половину мора да зна коју маржу враћа. Новац је место где спојено путовање постаје скупо, јер се ставке намирују по различитим роковима, а повраћај за лет не стиже када стиже отказ хотела.
Где стоји ова платформа
Отворено: платформа нуди API-је за летове и хотеле, а приступ почиње разговором, не кључем који сами преузимате. Услуге се укључују по tenant-у, па tenant који продаје хотеле, а не туре, не носи површину за туре. Ништа овде не обећава један позив који атомски резервише обе половине, и не треба да пројектујете као да обећава. Третирајте их као две резервације, што и јесу, под путовањем које ви поседујете.
Ако желите да видите стварне позиве и услове пре него што градите око њих, почните од странице о туристичким API-јима и понесите редослед којим намеравате да резервишете. Ако још одлучујете шта вам бесплатан приступ доноси, текст бесплатан API за резервације хотела редом наводи врсте бесплатног.
Колико кошта грешка
Скупа верзија је тиха. Купац има карту до једног града, собе нема, и прво што чујете је порука ноћу, са аеродрома. Јефтиније, али и даље стварно: каса која показује један умирујући износ, а онда, после провере цене, други број на који купац није пристао; повраћај који врати лет и заборави хотел; и статус "резервисано" док добављач каже другачије.
Ништа од тога не тражи паметно решење. Тражи да путовање буде прави објекат, да редослед буде одлука коју је неко записао, и поновну проверу обе цене у последњем тренутку пре него што било која буде потврђена. Изградите то једном и каса може да изгледа једноставно као што је задатак тражио.