Kuunganisha API ya kuhifadhi tiketi za ndege: yasiyoandikwa kwenye nyaraka

Kazi iliyo kwenye ubao inasema "ongeza safari za ndege". Umewahi kuunganisha mfumo wa malipo, hesabu ya gharama za usafirishaji, labda ramani pia, na picha uliyonayo kichwani ndiyo iliyo wazi zaidi: tafuta, onyesha matokeo, kata kadi, imekwisha. Kisha uhifadhi halisi wa kwanza unarudi na bei tofauti na ile iliyokuwa kwenye ukurasa wa matokeo, wa pili unaisha muda na hakuna anayeweza kusema kama mteja ana kiti, na mtu wa idara ya uendeshaji anauliza kwa nini kuna uhifadhi lakini hakuna tiketi. Kuunganisha API ya kuhifadhi tiketi za ndege kwa nje kunafanana na ukurasa wa malipo wa biashara mtandaoni. Ndani yake, ni muamala uliosambazwa dhidi ya mifumo iliyoundwa muda mrefu kabla ya REST, na mshangao mwingi unatoka kwenye pengo hilo.
Makala hii ni kwa msanidi ambaye hajawahi kuona PNR. Haihusu endpoint za msambazaji fulani; majina hubadilika kati ya watoa huduma, umbo halibadiliki.
Mpangilio wa miito katika kuunganisha API ya kuhifadhi tiketi za ndege
Karibu kila API ya safari za ndege, vyovyote inavyoita mbinu zake, hupitia hatua nne zilezile. Kuweka mipaka sahihi kati yake ndiyo sehemu kubwa ya kazi.
| Hatua | Unachopata | Unachopaswa kuhifadhi | Kinachoharibika |
|---|---|---|---|
| Kutafuta | Ratiba za safari zenye bei na ufunguo wa ofa au nauli usioeleweka | Hakuna cha kudumu — matokeo huchakaa haraka | Unaichukulia bei kuwa ya mwisho; ufunguo unaisha kabla ya malipo |
| Kuthibitisha bei | Bei iliyothibitishwa, kanuni za nauli, mizigo, wakati mwingine taarifa za lazima za abiria | Ofa iliyothibitishwa na muda wake wa kuisha | Bei imebadilika; daraja limeisha; kanuni ni tofauti na ulizoonyesha |
| Kuhifadhi | Uhifadhi — PNR — wenye msimbo wa uhifadhi na tarehe ya mwisho ya kutoa tiketi | Kumbukumbu yako mwenyewe, msimbo, tarehe ya mwisho, taarifa za abiria kama zilivyotumwa hasa | Muda kuisha bila jibu; PNR mbili; majina kukataliwa |
| Kutoa tiketi | Namba za tiketi za kielektroniki; hapa ndipo pesa zinafungwa kweli | Kila namba ya tiketi, ikiwa imehusishwa na abiria na sehemu ya safari yake | Tiketi kutolewa kwa sehemu; shirika kufuta uhifadhi kwa sababu tarehe ya mwisho imepita |
Safu ambayo watu hubishana nayo ni ya tatu, kwa sababu API nyingi hukuruhusu kuhifadhi na kutoa tiketi kwa mwito mmoja. Itumie ukipenda. Katika ulimwengu wa mashirika ya ndege, mambo hayo mawili bado ni tofauti: PNR inaweza kuwepo bila tiketi, na utoaji wa tiketi unaweza kushindwa baada ya PNR kuundwa. Endpoint iliyounganishwa huficha tu wakati ambapo kimoja kilifaulu na kingine hakikufaulu, kwa hiyo modeli yako ya data bado inahitaji nafasi ya hali hiyo.
Angalia pia kile ambacho utafutaji haurudishi: ahadi. Matokeo ni tangazo. Hatua ya kuthibitisha bei ndiyo nukuu, na tiketi pekee ndiyo mauzo.
Kwa nini bei uliyoitafuta si bei unayohifadhi
Msanidi wa wavuti anatarajia katalogi. Viti vya shirika la ndege si katalogi. Safari moja huuzwa kwa madaraja ya uhifadhi, kila daraja likiwa ndoo ya viti kwa nauli moja, na shirika hufungua na kufunga ndoo hizo mfululizo kadiri ndege inavyojaa. Matokeo ya utafutaji huundwa haraka kutokana na upatikanaji ambao huenda tayari umechelewa kidogo; hadi mtumiaji anapomaliza kuandika pasipoti mbili, daraja la bei nafuu zaidi kwenye safari hiyo linaweza kuwa limefungwa. Hatua ya kuthibitisha inauliza tena, na jibu la kweli wakati mwingine ni la juu zaidi.
Kodi nazo husogea zenyewe. Hukokotolewa upya wakati wa kuthibitisha kwa abiria na njia halisi, na mtoto au mtoto mchanga ana bei tofauti na mtu mzima ambaye utafutaji ulimdhania. Kama duka lako linaonyesha shilingi wakati msambazaji ananukuu kwa sarafu nyingine, ubadilishaji wa sarafu ni sehemu nyingine ambapo namba husogea.
Matokeo yake kwenye muundo ni rahisi na mara nyingi hurukwa: kamwe usikate pesa kwa bei ya utafutaji. Endesha hatua ya kuthibitisha kabla ya malipo, linganisha, na kama kiasi kimebadilika, onyesha namba mpya na uombe idhini. Nyongeza yoyote ya bei unayoweka inapaswa kukokotolewa upya juu ya nauli mpya, si kubebwa kutoka ukurasa wa matokeo — mantiki ni ileile ambayo wakala hupitia anapoweka mkakati wa nyongeza ya bei mtandaoni, na inavunjika kwa njia ileile msingi unaposogea chini yake.
Idempotency, na maana ya muda kuisha wakati wa kuhifadhi
Sehemu hii isome mara mbili.
Mwito wa kuhifadhi unapoisha muda, hujui kilichotokea. Ombi huenda halikufika kabisa. Huenda lilifika na kushindwa. Au — hali inayouma zaidi — lilifika, msambazaji akaunda PNR kwenye shirika la ndege, na jibu likapotea njiani likirudi kwako. Kwa msimbo wako, zote tatu zinaonekana sawa. Kwa shirika la ndege, ya tatu ni uhifadhi hai unaoshikilia viti kwa jina la mteja wako.
Mazoea kutoka miunganisho mingine ni kujaribu tena. Hapa, kujaribu tena bila kuangalia kunaweza kuzalisha PNR ya pili kwa abiria walewale kwenye safari ileile. Mashirika ya ndege huchukulia uhifadhi maradufu kuwa ukiukaji wa sera; kulingana na shirika na makubaliano ya wakala, matokeo yanaweza kuwa kufutwa kiotomatiki kwa uhifadhi mmoja au yote miwili hadi hati ya deni — ADM — inayotumwa kwa aliyezitoa. Wakala atakayeipokea atataka kujua kwa nini mfumo wako ulihifadhi mara mbili.
Kinachofanya kazi, takriban kwa mpangilio huu:
- Unda kumbukumbu yako mwenyewe ya uhifadhi kabla ya kupiga mwito nje, ihifadhi, na itume pamoja na ombi popote API inapokubali kumbukumbu ya mteja. Kama API inaunga mkono ufunguo wa idempotency, utumie; kama haiungi, kumbukumbu yako bado ndiyo itakayokuwezesha kuutafuta uhifadhi baadaye.
- Weka hali ya "haijulikani" waziwazi kwenye modeli. Inasubiri, imethibitishwa, imeshindwa — na haijulikani. Muda kuisha huhamisha uhifadhi kwenda haijulikani, si kwenda imeshindwa.
- Tatua hali isiyojulikana kwa kuuliza, si kwa kurudia. Pata uhifadhi kwa kumbukumbu yako, au orodhesha uhifadhi wa hivi karibuni wa abiria hao, kabla ya kuamua kujaribu tena.
- Endesha kazi ya upatanisho inayopitia kila kilichobaki haijulikani, kukilinganisha na anachoripoti msambazaji, na kupeleka kisichoweza kutatuliwa kwenye foleni ya binadamu badala ya kubahatisha.
Muda kuisha wakati wa kutoa tiketi ni tatizo lilelile lenye pesa ndani yake. Ukikata kadi kabla ya kutoa tiketi na utoaji ukakwama, una mteja aliyelipa na huenda hana tiketi. Ukitoa tiketi kabla ya kukata pesa na ukataji ukashindwa, umetoa hati ambayo mtu lazima ailipe kwa shirika la ndege. Muundo wa kawaida ni kuidhinisha kadi kwanza, kutoa tiketi, kisha kukata pesa ikifaulu — jambo la msingi ni kuamua kwa makusudi, si kugundua kwenye mfumo halisi.
Dhana za usafiri wa anga zinazowashangaza wasanidi wa wavuti
Hakuna hata moja iliyo ngumu. Kila moja imeshamgharimu mtu wiki nzima kwa sababu hakujua ipo.
PNR si tiketi
PNR ni rekodi ya uhifadhi: abiria, sehemu za safari, mawasiliano, tarehe ya mwisho. Tiketi ni hati iliyolipiwa inayompa abiria haki ya kusafiri. PNR isiyo na tiketi huisha kwenye tarehe yake ya mwisho na viti hurudi sokoni, wakati mwingine kimya kimya upande wako.
Majina karibu hayabadiliki
Baada ya tiketi kutolewa, nauli nyingi haziruhusu kubadilisha jina zaidi ya marekebisho madogo, na kinachohesabiwa kuwa kidogo hutofautiana kati ya mashirika. Jina lazima lilingane na hati ya kusafiria. Kusanya jina la ukoo na majina mengine kando, usiruhusu cheo kutoka sehemu ya maandishi huru kuingia kwenye sehemu ya jina, na thibitisha kabla ya mwito wa kuhifadhi, si baadaye.
Aina za abiria zina bei, si mapambo
Mtu mzima, mtoto na mtoto mchanga ni aina za nauli, na umri unaoamua kwa kawaida ni umri siku ya safari, si siku ya kuhifadhi. Mtoto mchanga anayebebwa mapajani kwa kawaida hachukui kiti na anaweza kusafiri tu na mtu mzima. Ukikosea aina, hatua ya kuthibitisha bei itashindwa au itanukuu nauli isiyo sahihi.
Saa ni za eneo husika, na sehemu za safari si mikondo
Saa za kuondoka na kuwasili hutolewa kwa saa za eneo la kila uwanja wa ndege. Usizibadilishe kwenda saa za mtumiaji kwa ajili ya kuonyesha, na usikokotoe muda wa safari kwa kutoa bila kuzingatia tofauti za saa. Safari ina sehemu; sehemu yenye kituo cha kiufundi ina mkondo zaidi ya mmoja. Kiolesura chako na data yako lazima vikubaliane kipi kinaitwa "kituo".
Mambo hutokea baada ya mauzo
Mashirika ya ndege hubadilisha ratiba baada ya tiketi kutolewa. Uhifadhi uliokuwa sahihi wakati wa kutoa tiketi unaweza wiki kadhaa baadaye kuonyesha saa mpya, namba mpya ya safari au muunganiko uliokatika, na kulingana na msambazaji utajua kupitia arifa, foleni au kwa kupata uhifadhi upya. Panga ukijua kwamba uhifadhi utabadilika baada ya wewe kuacha kuuangalia.
Void si kurejesha pesa
Muda mfupi baada ya kutoa tiketi kwa kawaida kuna dirisha ambalo tiketi inaweza kufanyiwa void kana kwamba haikuwahi kuwepo. Baada ya dirisha hilo, kinachowezekana ni kurejesha pesa kwa mujibu wa kanuni za nauli pekee, ambako kunaweza kuwa na adhabu au kusirudishe chochote. Dirisha na kanuni zake ni za msambazaji na makubaliano ya utoaji tiketi; zisome kabla ya kujenga kitufe cha "futa".
Gharama ya kukosea
Kushindwa katika muunganisho wa safari za ndege ni ghali kwa namna maalumu: kunawaangukia watu, si kumbukumbu za mfumo. Uhifadhi maradufu unakuwa simu kwa shirika la ndege na huenda hati ya deni dhidi ya akaunti ya wakala. Mteja aliyekatwa pesa bila tiketi anakuwa urejeshaji wa pesa, malalamiko na hatari ya chargeback. Tiketi iliyotolewa bila malipo kufaulu inakuwa deni kwa shirika la ndege ambalo mtu lazima alipe. Mabadiliko ya ratiba ambayo hakuna aliyeyashughulikia yanakuwa msafiri uwanjani kwa ajili ya ndege iliyoondoka mapema.
Hakuna kati ya hayo kinachojitokeza kwenye jaribio la njia laini. Andika njia zisizo laini kwanza: muda kuisha wakati wa kuhifadhi, bei iliyopanda, tiketi iliyoshindwa baada ya PNR kuwepo, void baada ya malipo kufaulu. Hizo zikishughulikiwa, njia laini ndiyo sehemu rahisi.
Kujaribu dhidi ya API ya safari za ndege
Mazingira ya majaribio ya wasambazaji yana manufaa lakini hayajakamilika. Huwa tulivu kuliko mfumo halisi, kwa hiyo madaraja kuisha na bei kubadilika hutokea mara chache, na baadhi hayaigi kabisa muda kuisha. Yatumie kwa umbo la miito na makosa ya uthibitishaji, kisha panga jaribio lililodhibitiwa kwenye mfumo halisi kwa uhifadhi wa kweli utakaoufanyia void ndani ya dirisha — huku idara ya uendeshaji ikijua unafanya hivyo.
Kama uunganishe kabisa au la ni swali tofauti. Kama unachohitaji hasa ni duka la mtandaoni badala ya viti ghafi ndani ya mfumo wako, faida na hasara zimeelezwa katika white label au kujenga booking engine yako, na hoja hiyohiyo inahusu portal ya B2B kwa mawakala wadogo. Kama kweli unataka viti hivyo ndani ya msimbo wako, jukwaa hili linatoa API za safari za ndege na hoteli, na ufikiaji huanza kwa mazungumzo kuhusu matumizi yako, si ufunguo wa kujihudumia — ambao pia ndio wakati sahihi wa kuuliza kila swali lililo hapo juu.