API ya kuhifadhi hoteli na ndege: safari moja, uhifadhi miwili

Tiketi inasema: "ongeza hoteli kwenye mtiririko wa kuhifadhi ndege, malipo mara moja, jumla moja." Ni ombi la busara kutoka kwa meneja wa bidhaa na linasikika kama kazi ya siku moja, kwa sababu tayari una utafutaji wa ndege na tayari una ukurasa wa malipo. Wiki tatu baadaye timu inabishana kuhusu kinachopaswa kutokea shirika la ndege likithibitisha na hoteli isithibitishe. API ya kuhifadhi hoteli na ndege si muunganisho mmoja wenye aina mbili za matokeo. Ni miunganisho miwili inayoshiriki kikapu kimoja.
Kadiri msimbo unavyokubali hilo mapema, ndivyo sehemu ndogo yake itakavyoandikwa upya. Kinachofuata ni sehemu ambayo miongozo ya muunganisho huiruka: jinsi nusu hizi mbili zinavyotofautiana, ipi uithibitishe kwanza, na safari inapaswa kuwa nini ndani ya muundo wako wa data.
Nusu hizi mbili hazitendi sawa
Zote mbili hurudi kama JSON yenye bei na namba ya marejeo, kwa hiyo kwenye mtandao zinaonekana sawa. Hazifanani hata kidogo katika kile zinachokuahidi baada ya kupata namba hiyo ya marejeo.
| Swali | Ndege | Hoteli |
|---|---|---|
| Unachoshika baada ya kuhifadhi | Uhifadhi (PNR) ambao bado si tiketi | Uthibitisho ambao mara nyingi tayari ndio kitu ulichouza |
| Bei inadumu kwa muda gani | Hadi nauli ipangwe upya wakati wa kuhifadhi, na inaweza kutofautiana na ya utafutaji | Hadi kiwango kiishe muda wake, na kiwango kinaweza kubadilika kati ya kuangalia upatikanaji na kuhifadhi |
| Kinachokithibitisha | Kutoa tiketi, mara nyingi ndani ya muda maalum | Uthibitisho wa msambazaji, wakati mwingine papo hapo, wakati mwingine unasubiri |
| Kinavyotenguliwa | Void kama kimewahiwa mapema, vinginevyo marejesho chini ya kanuni za nauli, mara nyingi pamoja na adhabu | Kughairi chini ya sera ya kiwango chenyewe, bure hadi muda fulani kwa viwango vingi |
| Kinachobadilisha namba dakika za mwisho | Nauli, kodi, wakati mwingine sarafu ya nauli | Kodi na ada zinazolipwa hotelini, aina ya chakula kilichojumuishwa, chumba kinachotolewa kwa kweli |
Unaweza kutokubaliana na safu moja, kwa kuwa wasambazaji hutofautiana, lakini si na umbo lake: nusu moja ina hatua ya kutoa tiketi na nyingine ina kipindi cha kughairi, na hivyo viwili havilingani kwa wakati. Tulizungumzia mfuatano wa upande wa ndege katika muunganisho wa API ya kuhifadhi ndege na tatizo la msambazaji mzito upande wa hoteli katika usanifu wa mteja wa API ya upatikanaji wa hoteli. Makala hii inaanzia pale zile zinapoishia, kwenye kiungo.
Uhifadhi upi uanze kwanza?
Hakuna anayekuambia kuwa huu ni uamuzi wa usanifu, na ndio uamuzi unaoweka gharama ya kushindwa.
Tuseme mteja ananunua ndege na hoteli kwa tarehe zilezile. Unatuma uhifadhi mmoja kisha mwingine. Mambo matatu yanaweza kutokea: yote mawili yanafaulu, au mmoja unashindwa, au mmoja unashindwa baada ya mwingine kufaulu. La kwanza ni siku nzuri. Mengine mawili ndiyo yanaamua foleni yako ya huduma kwa wateja.
Ukitoa tiketi ya ndege kwanza na hoteli ikakataa baadaye, una mteja mwenye kiti cha kwenda mji fulani bila chumba, ambaye tayari amekatwa pesa, na marejesho ya tiketi yenye adhabu. Ukihifadhi hoteli kwanza na ndege ikashindwa baadaye, unashika chumba ambacho mara nyingi unaweza kukighairi bure, kwa hiyo kurekebisha ni rahisi. Hatari ya upande wa pili pia ni ya kweli, kwa kuwa kiwango cha hoteli kisichoweza kughairiwa ndicho kitu kibaya zaidi kukishika, kwa hiyo soma masharti ya kughairi ya kiwango hicho kabla hujakiruhusu kuanza kwanza.
Hii ni kanuni ya uzoefu, si sheria, na hoja ni kwamba unapaswa kuchagua mpangilio kwa makusudi. Thibitisha nusu iliyo rahisi kutengua kabla ya iliyo ngumu, kagua bei ya zote mbili kabla tu ya yoyote kuthibitishwa, na andika utakachofanya kwa kila moja ya matokeo matatu. Wakaguzi wa msimbo mara chache huuliza. Wateja daima hugundua.
Safari moja, uhifadhi miwili
Umbo linalodumu ni rekodi ya safari inayomiliki uhifadhi miwili, kila mmoja ukiwa na namba yake ya marejeo, hali yake na masharti yake. Mteja anaona jumla moja. Hifadhidata yako inaona safu mbili, na jumla ni hesabu unayoifanya wewe, si kitu kilichopo kwa msambazaji.
Tenganisha hali hizo mbili. "Imethibitishwa" kwa hoteli na "tiketi imetolewa" kwa ndege si hali moja, na safu moja ya hali inayozibana pamoja, mapema au baadaye, itaandika "imehifadhiwa" juu ya safari iliyohifadhiwa nusu.
Tenganisha pia seti mbili za masharti ya mabadiliko, na uzionyeshe. Jumla inayoonyeshwa inaficha kwamba kuhamisha tarehe ni bure upande mmoja na kuna ada upande mwingine. Ikiwa sehemu ya mbele ya programu yako inaonyesha "badilisha tarehe" kama kitufe kimoja, amua kinachofanya pale nusu moja tu inapoweza kuhamishwa, kabla mteja hajakugundulia. Vivyo hivyo kwa faida unayoongeza (markup): ukiongeza yako kwa kila huduma, kama wauzaji wengi wanavyofanya, jumla ya safari ina faida mbili, na marejesho ya nusu moja yanahitaji kujua ni faida ipi inayorudishwa. Pesa ndipo safari iliyounganishwa inapokuwa ghali, kwa sababu kila mstari hulipwa kwa ratiba tofauti, na marejesho ya ndege hayafiki wakati ule ule kughairi kwa hoteli kunapofanyika.
Jukwaa hili liko wapi
Kwa uwazi: jukwaa hili linatoa API za ndege na hoteli, na upatikanaji huanza kama mazungumzo badala ya ufunguo wa kujihudumia. Huduma huwashwa kwa kila mpangaji (tenant), kwa hiyo mpangaji anayeuza hoteli bila ziara hambebi sehemu ya ziara. Hakuna kitu hapa kinachoahidi wito mmoja unaohifadhi nusu zote mbili kwa pamoja kwa wakati mmoja (atomically), na hupaswi kusanifu kana kwamba kipo. Zichukulie kama uhifadhi miwili zilivyo, chini ya safari unayoimiliki wewe.
Ukitaka kuona wito halisi na masharti kabla ya kujenga juu yake, anzia kwenye ukurasa wa API za usafiri na uje na mpangilio unaokusudia kuhifadhi. Ikiwa bado unaamua upatikanaji wa bure unakupa nini, API ya bure ya kuhifadhi hoteli inaeleza aina za "bure".
Gharama ya kukosea
Toleo ghali zaidi ni lile la kimya. Mteja amepewa tiketi ya kwenda mji fulani na chumba hakipo, na mara ya kwanza unasikia habari hiyo ni ujumbe wa usiku kutoka uwanja wa ndege. Rahisi zaidi lakini bado ya kweli: ukurasa wa malipo unaoonyesha jumla moja ya kutuliza kisha, baada ya kukagua bei, namba ya pili ambayo mteja hakuikubali; marejesho yanayorudisha ndege na kusahau hoteli; na hali inayosema "imehifadhiwa" wakati msambazaji anasema vinginevyo.
Hakuna kati ya hayo kinachohitaji suluhisho la kijanja. Kinachohitajika ni safari kuwa kitu halisi, mpangilio kuwa uamuzi ambao mtu ameuandika, na kukagua upya bei zote mbili dakika ya mwisho kabla ya yoyote kuthibitishwa. Jenga hilo mara moja na ukurasa wa malipo unaweza kuonekana rahisi kama tiketi ilivyotaka.