API ya upatikanaji wa hoteli: kubuni kwa wasambazaji wa polepole

Tiketi kwa kawaida huonekana haina hatari. "Ongeza utafutaji wa hoteli kwenye ukurasa wa booking — msambazaji ametupa API ya upatikanaji wa hoteli, kuna sandbox, ni kazi ya sprint moja." Unasoma nyaraka, unatuma ombi la watu wazima wawili Zanzibar kwa usiku tatu, na jibu linarudi. Kisha unatuma ombi lilelile kwa jiji lenye hoteli nyingi zaidi, na hakuna kinachorudi kwa muda mrefu usiopendeza. Linapofika hatimaye, ni hati kubwa kiasi cha kumfanya parser yako ya JSON kutafakari maamuzi ya maisha yake.
Hapo ndipo kazi inabadilika umbo. Upatikanaji wa hoteli si lookup. Ni fan-out: swali moja kutoka kwa mtumiaji wako linakuwa maswali mengi kwa wasambazaji wengi, kila mmoja akijibu kwa kasi yake, kwa msamiati wake, na kwa wazo lake mwenyewe la "chumba" ni nini. Client unayojenga lazima ibaki na manufaa muda wote ambao fan-out hiyo bado inatatuliwa. Makala hii inahusu kubuni client hiyo — kwa developer anayeijua REST na JSON vizuri lakini hajawahi kulazimika kuieleza hoteli kwa nini bei isiyorejesheka ya mgeni ilionyeshwa kama kughairi bure.
Kwa nini API ya upatikanaji wa hoteli ni ya polepole kuliko endpoint unazozizoea
Kwa nje, utafutaji wa ndege na utafutaji wa hoteli vinafanana: swali linatoka, chaguo zenye bei zinarudi. Ndani yake, si tatizo lilelile. Ikiwa umesoma maelezo yetu kuhusu kile ambacho kuunganisha API ya kuhifadhi ndege kunahitaji kweli, unajua kwamba bei unayoitafuta si mara zote bei unayoihifadhi. Hoteli zinaongeza ugumu wa pili juu yake: wingi.
Jiji moja linaweza kuwa na mamia ya hoteli. Kila hoteli inauza aina kadhaa za vyumba. Kila aina ya chumba inauzwa chini ya rate plan kadhaa — na kifungua kinywa, bila kifungua kinywa, inayorejesheka, isiyorejesheka, bei ya wanachama, bei ya kifurushi. Kila rate plan inaweza kutoka kwa chanzo zaidi ya kimoja: bedbank, channel manager, mkataba wa moja kwa moja, au muuzaji wa jumla uliyesaini naye kwa sababu allotment yake katika hoteli moja ilikuwa bora kuliko ya mtu mwingine yeyote. Zidisha yote hayo na utafutaji "rahisi" ni mti mkubwa, ulioundwa kutoka vyanzo kadhaa visivyokubaliana kuhusu majina wala ID.
Kwa hiyo sehemu ya polepole mara chache huwa ni code yako. Ni msambazaji wa polepole zaidi uliyeamua kumsubiri.
Matokeo ya hatua kwa hatua au jibu kamili: chagua kwa makusudi
Kuna njia mbili za kweli za kurudisha matokeo ya utafutaji wa hoteli, na integration nyingi huishia mahali pasipopendeza katikati.
Subiri vyote. Backend yako inasambaza ombi, inasubiri kila msambazaji ajibu au timeout ifike, inaunganisha, inaondoa marudio, inapanga, na inarudisha orodha moja kamili. Matokeo ni safi: ombi moja, jibu moja, bei zinazoweza kulinganishwa kwa sababu zote ziko mezani. Gharama yake ni kwamba mtumiaji wako anakodolea macho spinner kwa muda wote ambao msambazaji wako wa polepole zaidi anachukua, kila mara.
Tuma ulicho nacho. Backend yako inaanzisha fan-out na mara moja inarudisha search handle. Client inafanya polling kwenye handle hiyo, au inashikilia stream wazi, na inapokea matokeo kwa makundi kadri wasambazaji wanavyojibu. Hoteli za kwanza zinaonekana haraka. Gharama yake ni ugumu kila mahali pengine: orodha inajipanga upya wakati mtumiaji anaisoma, alama ya "nafuu zaidi" inaweza kuhama, na hoteli iliyotokea kwa msambazaji mmoja baadaye inaweza kupata bei nafuu zaidi kutoka kwa mwingine.
Ikiwa interface yako ni ukurasa wa utafutaji mbele ya binadamu, hatua kwa hatua karibu kila mara ndiyo sahihi — mtu huyo anavinjari, haendeshi batch job, na ukurasa unaoonekana ukifanya kazi ni bora kuliko ukurasa unaofikiri kimya kimya. Ikiwa mtumiaji wako ni mashine nyingine — job ya kulinganisha bei, chombo cha booking cha kampuni kinachohitaji jibu moja la mwisho — kusubiri mara nyingi ni rahisi zaidi na sahihi.
Utakachochagua chochote, kanuni tatu huiweka client ya hatua kwa hatua timamu:
- Kila kundi linabeba hali ya kukamilika ya utafutaji mzima, ili client ijue tofauti kati ya "hakuna matokeo mengine bado" na "hakutakuwa na matokeo mengine kamwe".
- Matokeo yanaunganishwa kwa ufunguo thabiti wa hoteli kwenye server, hayaongezwi mwishoni tu. Client haipaswi kamwe kujitafutia yenyewe kwamba kadi mbili ni jengo moja.
- Kupanga kwa bei ni kwa muda tu hadi utafutaji ukamilike, na interface inasema hivyo. Watumiaji husamehe orodha inayotulia polepole; hawasamehe alama ya "bei ya chini kabisa" inayogeuka kuwa si kweli.
Kuunda vyumba na rate plan ili visiporomoke
Hapa ndipo integration nyingi za hoteli hushindwa kimya kimya, na kushindwa huko hujitokeza miezi baadaye kama tiketi ya support, si ripoti ya hitilafu.
Muundo unaovutia ni muundo bapa: hoteli ina orodha ya ofa, kila ofa ina jina la chumba na bei. Unaonekana vizuri. Kisha msambazaji mmoja anarudisha "Deluxe King" na "Deluxe Room, 1 King Bed" kwa chumba ambacho ni kimoja dhahiri, msambazaji mwingine anarudisha jina lilelile kwa vyumba viwili tofauti kabisa (kimoja kinaangalia jiji, kingine hakiangalii), na wa tatu anarudisha bei ya kila usiku wakati wengine wote wanatoa bei ya ukaaji mzima. Orodha bapa haiwezi kukwambia unaangalia kipi. Inaviyaonyesha tu.
Muundo unaostahimili kukutana na wasambazaji halisi una angalau ngazi nne, na unazitenganisha:
| Ngazi | Inahifadhi nini | Kosa la kuepuka |
|---|---|---|
| Hoteli | ID yako thabiti, iliyounganishwa na code ya kila msambazaji | Kutumia ID ya hoteli ya msambazaji kama primary key |
| Chumba | Idadi ya wageni, mpangilio wa vitanda, maandishi asili ya msambazaji bila kubadilishwa | "Kusafisha" majina ya vyumba hadi vyumba viwili tofauti viwe kimoja |
| Rate plan | Board basis, uwezo wa kurejeshewa, aina ya malipo, msambazaji aliyeileta | Kuweka kifungua kinywa au uwezo wa kurejeshewa ndani ya jina la chumba |
| Bei | Jumla ya ukaaji mzima, sarafu, kodi na ada zilizomo na zinazolipwa hotelini | Kuonyesha bei ya usiku mmoja kando ya bei za ukaaji mzima, au kuficha ada za kulipa wakati wa kuwasili |
Unaweza kutokubaliana na mahali mistari inapochorwa — timu nyingine hutenga idadi ya wageni kuwa ngazi yake, jambo la busara mara unapouza booking za vyumba vingi. Usichoweza kufanya ni kuunganisha ngazi kwa sababu tu interface inaonyesha mbili kati yake. Interface inaweza kuzibapa wakati wa kuonyesha. Data haipaswi.
Jambo moja dogo linastahili sentensi yake: hifadhi maelezo ghafi ya chumba kutoka kwa msambazaji kando ya toleo ulilolisanifisha. Mgeni anapofika na kupewa chumba tofauti na kilicho kwenye voucher yake, swali la kwanza la kila mtu ni msambazaji alituma nini hasa.
Sera za kughairi ni data, si aya
Wasambazaji wengi hurudisha masharti ya kughairi kama maandishi huru: "Kughairi bure hadi siku 3 kabla ya kuwasili, baada ya hapo adhabu ya usiku 1." Inavutia sana kuonyesha maandishi hayo na kuendelea.
Usifanye hivyo. Maandishi hayawezi kulinganishwa, kupangwa, kuchujwa wala kutekelezwa. Mtumiaji wako anataka kuchuja bei zinazorejesheka. Timu yako ya fedha inataka kujua ni booking zipi zitakuwa zisizorejesheka kesho ili wakala amfuatilie mteja kabla muda haujapita. Mtiririko wako wa baada ya booking unahitaji kumwambia mteja, wakati anabonyeza kughairi, atatozwa kiasi gani hasa. Hakuna kati ya hayo kinachofanya kazi juu ya sentensi.
Unda kila sera kama orodha iliyopangwa ya vipindi vya adhabu: kuanzia wakati huu, hadi wakati ule, tozo ni kiasi hiki (au sehemu hii ya ukaaji, au usiku huu mwingi). Mipaka ni timestamp zenye saa za eneo — saa za eneo la hoteli, si za server yako wala za mtumiaji — kwa sababu "siku 3 kabla ya kuwasili" ni wakati tofauti kulingana na unahesabu usiku wa manane wa nani. Hifadhi maandishi asili ya msambazaji kando ya toleo lenye muundo, onyesha toleo lenye muundo, na chukulia kutolingana kati yao kama jambo la kuchunguza, si la kuficha.
Na kagua sera upya wakati wa booking, si wakati wa utafutaji pekee. Sera hubadilika kati ya maombi hayo mawili mara nyingi zaidi kuliko yeyote anavyotarajia.
Kukosea kunagharimu nini hasa
Utafutaji wa polepole unakugharimu mauzo, jambo baya lakini linaloonekana — mtu atalalamika. Kushindwa kwa gharama kubwa ni kule kwa kimya.
Bei iliyoonyeshwa kama inayorejesheka ambayo msambazaji anaichukulia kama isiyorejesheka ni mzozo na mteja aliye na picha ya skrini, na mara nyingi wakala mwenyewe ndiye hulipa adhabu. Bei ya usiku mmoja iliyoonyeshwa kama jumla ya ukaaji inauza vyumba chini ya gharama hadi mtu wa uhasibu atambue. Chumba kilichounganishwa na chumba kingine kinapeleka familia ya watu wanne kwenye chumba cha watu wawili. Ada za kulipa hotelini ambazo hazikuwahi kuonyeshwa zinageuza tathmini ya nyota tano kuwa chargeback. Kila moja ya haya ni uamuzi wa uundaji wa data uliofanywa katika sprint ya kwanza, kwa kawaida chini ya lebo ya "tutasafisha baadaye".
Cache: unachoruhusiwa kuhifadhi na usichoruhusiwa
Kila timu inayounganisha API ya hoteli hatimaye huuliza kama inaweza kuweka matokeo kwenye cache ili utafutaji uwe wa haraka na nafuu. Jibu ni ndiyo, kwa baadhi ya vitu, na mstari kati yao ni muhimu kuliko takwimu yoyote ya utendaji.
Maudhui yasiyobadilika — majina ya hoteli, anwani, kuratibu, picha, orodha za huduma, maelezo ya vyumba — hubadilika mara chache na ndiyo hasa unayopaswa kuweka kwenye cache kwa nguvu katika hifadhi yako. Kagua masharti ya msambazaji kuhusu jinsi unavyoruhusiwa kuyahifadhi na kuyaonyesha; leseni nyingine zinaweka mipaka. Kuyachukua moja kwa moja kila utafutaji ni polepole bila faida.
Bei na upatikanaji wa moja kwa moja ni jambo jingine. Bei iliyo kwenye cache ni makisio ya kile msambazaji atatoza, na wasambazaji hawaheshimu makisio yako. Cache ya muda mfupi ya matokeo ya utafutaji inaweza kukubalika kwa kuonyesha ukurasa — mradi kila njia ya booking inapiga bei upya kwa msambazaji kabla ya kuchukua pesa, na interface inachukulia bei iliyobadilika kama matokeo ya kawaida, si hitilafu. Wasambazaji wengine pia huweka kikomo cha uwiano wa utafutaji kwa booking; cache kali inayoficha trafiki yako halisi kwao si mwanya unaostahili kutegemewa.
Usichopaswa kamwe kuweka kwenye cache ni chochote kinachowakilisha ahadi: token ya bei iliyoshikiliwa, namba ya booking, makadirio ya adhabu ya kughairi. Hivyo ni mali ya mtumiaji mmoja na wakati mmoja.
Kabla hujasema imekamilika
Ukaguzi mfupi unaostahili kuendeshwa kwenye integration yako kabla haijabeba booking halisi:
- Utafutaji unarudisha hali ya kukamilika, na client inatenda tofauti kabla na baada yake.
- Hoteli zina ufunguo wa ID yako mwenyewe, na code ya kila msambazaji imeunganishwa nayo.
- Chumba, rate plan na bei ni vitu tofauti kwenye data yako, bila kujali skrini inaonyesha nini.
- Kila bei inasema kama ni ya usiku au ya ukaaji mzima, na kinacholipwa wakati wa kuwasili.
- Sera za kughairi zimehifadhiwa kama vipindi vya adhabu vyenye muda katika saa za eneo la hoteli, pamoja na maandishi asili.
- Njia ya booking inapiga bei upya na kusoma sera upya kabla ya kumtoza mtu yeyote.
- Hakuna kinachowakilisha ahadi kinachotolewa kutoka kwenye cache kamwe.
Ikiwa unapima kama ujenge haya yote moja kwa moja na kila msambazaji au uanze na jukwaa ambalo tayari limekutana na matatizo haya, upande wa mkataba ni muhimu kama code — makala yetu kuhusu mikataba ya hotel consolidator na bei za bedbank inaeleza nini cha kuomba. API zetu za ndege na hoteli hufunguliwa kwa mazungumzo, si kwa ufunguo wa kujihudumia; ikiwa hiyo ndiyo njia unayotaka kuichunguza, anza mazungumzo kwenye ukurasa wa travel APIs.
Fan-out haiondoki kamwe. Client nzuri huacha tu kujifanya kwamba haipo.