Kushughulikia makosa ya API ya booking engine: hitilafu tatu zinazogharimu pesa

Tiketi ya msaada inafika Alhamisi jioni. Mteja amelipa, ukurasa ukazunguka, kisha ukaonyesha kosa la jumla. Kadi imekatwa. Kumbukumbu zako zinaonyesha POST kwa msambazaji ambayo haikupata jibu kamwe. Je, shirika la ndege lilishikilia kiti? Hakuna anayeweza kukuambia, na mteja anasubiri. Kushughulikia makosa ya API ya booking engine kwa ubora ni zaidi kazi ya kutowahi kuwa katika nafasi hiyo, au angalau kujua hasa la kufanya unapokuwa humo.
Miongozo mingi ya uunganishaji huchukulia makosa kama orodha ya misimbo ya hali. Katika uhifadhi, misimbo ni sehemu rahisi. Kinachogharimu pesa ni idadi ndogo ya hali ambapo ombi linaonekana kushindwa lakini ulimwengu halisi ulibadilika, au linaonekana kufanikiwa lakini ulimwengu haukubadilika. Tatu kati ya hizo ni muhimu kuliko zingine.
Hitilafu ya kwanza: bei ilibadilika kati ya utafutaji na uhifadhi
Matokeo ya utafutaji ni nukuu, si mkataba. Nauli huhifadhiwa kwenye cache, hesabu ya viti hushirikiwa na kila njia ambayo msambazaji anauzia, na nambari uliyoonyesha saa 14:02 inaweza kuwa ya zamani baada ya dakika chache. Msambazaji anakuambia kwenye hatua ya create-booking, wakati mwingine kwa jibu safi la "fare changed", wakati mwingine kwa kurudisha kimya jumla tofauti ndani ya jibu linaloonekana kufanikiwa.
Aina ya pili ndiyo hatari. Msimbo wako ukisoma uthibitisho, ukahifadhi uhifadhi na kumtoza mteja kiasi alichokiona, tofauti hutoka kwenye faida yako, au baadaye kwenye ADM. Kwa hivyo kanuni ni rahisi: linganisha jumla ambayo msambazaji amethibitisha na jumla ambayo mteja alikubali, kila mara, kwenye msimbo, kabla ya kukamata malipo.
Cha kufanya zikitofautiana kinategemea ukubwa wa pengo na nani anayebeba. Senti chache za kupunguza au kuongeza kati ya sarafu ni kiwango cha uvumilivu unachoweka mara moja. Kitu chochote kikubwa zaidi kinarudi kwa mteja kama bei mpya yenye kitufe wazi cha kukubali. Usiwahi kulifyonza kiotomatiki, na usiwahi kulitoza kiotomatiki.
Hitilafu ya pili: imehifadhiwa, lakini haijatolewa tiketi
PNR kuwepo si sawa na tiketi kuwepo. Mtiririko mwingi huunda uhifadhi kwanza na kutoa e-ticket kama hatua tofauti, na kikomo cha muda katikati. Malipo yakifanikiwa na utoaji ukishindwa, unashikilia pesa za mteja na uhifadhi utakaoisha kwa saa yake yenyewe.
Hitilafu hii mara chache huwa na kelele. Simu ya issue inarudisha kosa au timeout, na uhifadhi unakaa katika hali ambayo hifadhidata yako inaiita "paid" huku msambazaji bado anasema "held". Wakati huo huo kikomo cha utoaji tiketi kinaendelea, na tofauti na foleni yako ya msaada, shirika la ndege halisubiri.
Ishughulikie kama hali yake yenyewe, si lahaja ya mafanikio au kushindwa. Uhifadhi unahitaji angalau hali hizi: created, held, payment captured, issuing, ticketed, failed-and-refundable. "Payment captured, issuing" ndiyo hali inayohitaji kipima muda: uhifadhi ukikaa hapo muda mrefu, kazi ya nyuma inapaswa kusoma tena uhifadhi kutoka kwa msambazaji na kuamua, si kusubiri binadamu aone. Uamuzi ni nafuu ukijua kikomo cha muda cha msambazaji, kwa sababu kinakuambia ni muda gani unaweza kujaribu tena kwa usalama kabla ya kurejesha pesa.
Hitilafu ya tatu: timeout yenye matokeo yasiyojulikana
Hii ndiyo tiketi ya Alhamisi jioni. Ombi lako liliondoka, hakuna jibu lililorudi, muunganisho ulikatika au lango likakata tamaa. Msambazaji huenda alilichakata kikamilifu, kwa sehemu, au hata hakulichakata.
Kishawishi ni kujaribu tena. Usijaribu tena simu ya create-booking kwa upofu, kwa sababu jaribio la pili linaweza kuzaa uhifadhi wa pili, na nakala ni gharama halisi: viti viwili vimeshikiliwa, labda tiketi mbili zimetolewa, na mzozo wa kurejesha pesa kwenye mojawapo.
Mpangilio salama ni: simama, soma, kisha amua. Simamisha mtiririko wa mteja kwa hali ya uaminifu "tunathibitisha uhifadhi wako". Soma upande wa msambazaji kwa kutafuta uhifadhi kwa kutumia kumbukumbu uliyoizalisha kabla ya simu (ndiyo sababu unaunda kumbukumbu yako ya mteja kwanza na kuituma kama msambazaji anaikubali). Kisha tu amua: ikipatikana, endelea kutoka hali halisi; isipopatikana baada ya dirisha la usindikaji la msambazaji, ni salama kujaribu tena mara moja.
Ikiwa msambazaji hakupi njia ya kutafuta kwa kumbukumbu yako, tafuta kwa jina la abiria, njia na tarehe ndani ya dirisha nyembamba, na uchukulie mlingano kama umepatikana. Mbaya kwa macho, lakini nafuu zaidi kuliko nakala.
Jedwali la maamuzi unaloweza kulipinga
| Unachokiona | Unachokijua | Cha kufanya | Usichofanya |
|---|---|---|---|
| Msambazaji anarudisha "fare changed" | Hakuna kilichohifadhiwa | Onyesha jumla mpya, omba idhini, endesha create tena | Endesha tena kwa bei ya zamani ukitumaini itapita |
| Mafanikio, lakini jumla ni tofauti na ile mteja aliyokubali | Uhifadhi upo kwa bei mpya | Shikilia malipo, muulize mteja, batilisha uhifadhi akikataa | Kamata kiasi cha zamani na ubebe tofauti |
| Malipo yamekamatwa, simu ya issue ina kosa | PNR ipo, hali ya tiketi haijulikani | Soma tena uhifadhi, jaribu issue ndani ya kikomo, rejesha pesa baada yake | Weka uhifadhi kama umeshindwa na usahau PNR |
| Timeout kwenye create | Matokeo hayajulikani | Tafuta kwa kumbukumbu yako, kisha endelea au jaribu mara moja | Kujaribu tena kwa upofu mara moja |
| Timeout kwenye cancel | Huenda bado una dhima ya sehemu ya safari | Soma tena hali kabla ya kumwambia mteja lolote | Kuonyesha "cancelled" kwa sababu kitufe kilibonyezwa |
Safu moja unaweza kuipinga: timu zingine hurejesha pesa kwenye kosa la kwanza la utoaji ili kumtuliza mteja. Inatetewa kwa tiketi ndogo na ni tabia mbaya kwa tiketi ghali, kwa kuwa unaweza kupoteza nauli ambayo dakika moja baadaye ungeiokoa.
Kukosea kunakugharimu nini
Kila hitilafu ina bili tofauti. Mabadiliko ya bei yaliyopuuzwa ni faida iliyopotea kwenye kila uhifadhi unaoguswa, mara nyingi bila kutambuliwa hadi ulinganisho. Booked-not-ticketed ni mteja anayefika uwanja wa ndege na uhifadhi uliokwisha muda na makato kwenye kadi yake, yaani chargeback na tatizo la sifa kwa wakati mmoja. Kujaribu tena kwa upofu wakati wa timeout ni uhifadhi nakala, na mashirika ya ndege hukagua nakala; mfululizo wa visa kama hivyo ndio aina ya jambo linaloishia kwenye ADM.
Hakuna kati ya haya lililo geni. Ni kazi ya mabomba isiyovutia inayotenganisha onyesho la majaribio na kitu unachoweza kukiacha kikiendelea wikendi nzima.
Jenga kazi ya ulinganisho kabla ya kuihitaji
Hitilafu zote tatu huishia pamoja: hifadhidata yako na ya msambazaji hazikubaliani. Kwa hivyo andika kazi inayozilinganisha kabla ya tukio la kwanza, si baada. Mzunguko wa usiku ni kiwango cha chini; kila dakika chache kwa chochote kilicho katika hali ya mpito ni bora zaidi. Inaorodhesha uhifadhi uliokwama katika held, issuing au unknown, inamuuliza msambazaji, kisha inarekebisha rekodi au kufungua tiketi yenye ushahidi ulioambatishwa.
Weka kila ombi na jibu la simu za uhifadhi, ikiwemo timeout, pamoja na kumbukumbu uliyotuma. Mteja akipinga makato, kumbukumbu hiyo ndiyo hoja yako. Pia inaweka mazungumzo ya latency kuwa ya kweli: tazama unachoweza na usichoweza kurekebisha kuhusu latency ya API ili uelewe kwa nini timeout ni ukweli wa maisha na si hitilafu ya kuondoa.
Ukiwa bado unaamua jinsi ya kuunganisha muunganisho wa msambazaji wenyewe, mwongozo katika uunganishaji wa API ya uhifadhi wa ndege unashughulikia mpangilio wa simu ambao makala hii inautegemea. Na ukitaka kujadili jinsi hali hizi zinavyolingana na API zetu za ndege na hoteli, ufikiaji huanza kwa mazungumzo: tazama ukurasa wa API za safari.