Kulinganisha API za usafiri: pima mihimili, si wauzaji

Una mawasilisho matatu ya wauzaji watatu yaliyofunguliwa kwenye vichupo vitatu. Kila moja lina slaidi yenye orodha ndefu ya mashirika ya ndege, slaidi ya idadi ya hoteli, sandbox, REST na JSON, na barua pepe ya msaada. Unaunda spreadsheet, unaweka alama ya vema kwenye kila kisanduku, na spreadsheet inaishia sare. Huo ndio mwisho wa kawaida wa kulinganisha API za usafiri kwa orodha ya vipengele — na ni mwisho usio sahihi, kwa sababu tofauti zitakazoamua mwaka wako ujao huonekana tu baada ya go-live: kwenye uhifadhi uliofanikiwa kwa msambazaji lakini ukapata timeout upande wako, kwenye refund ambayo hakuna anayeweza kuishughulikia, kwenye shirika la ndege lililokuwa kwenye orodha lakini tiketi yake haiwezi kutolewa kupitia njia hii.
Makala haya ni kwa ajili ya developer au kiongozi wa kiufundi anayepaswa kufanya uamuzi huo na kuutetea baadaye. Hayapangi wauzaji kwa daraja. Yanakupa mihimili ya kulinganisha, mpango wa majaribio unaotumia muda wake kwenye kushindwa, na maswali machache mafupi yanayokuambia haraka kama unazungumza na msambazaji halisi au na mtu anayeuza upya msambazaji wa mtu mwingine.
Kwa nini orodha ya vipengele huishia sare kila mara
Orodha inauliza kama uwezo fulani upo. Karibu kila API ya usafiri inaweza kujibu ndiyo kwa karibu kila mstari, kwa sababu mistari imeandikwa kwa kiwango cha ukurasa wa masoko: kutafuta, bei, kuhifadhi, kughairi, kutoa tiketi, webhook, sandbox. Swali linalowatofautisha si kama cancel ipo, bali nini kinatokea unapoiita kwenye uhifadhi ambao tiketi yake imeshatolewa saa kumi na mbili kabla ya kuondoka, kwenye nauli yenye adhabu, kupitia njia ambayo maudhui yalitoka kwa upande wa tatu. Orodha haina safu kwa ajili ya hilo.
Kuna tatizo la pili. Anayejaza orodha mara nyingi ni muuzaji mwenyewe. Unatoa alama kwa maelezo aliyojiandikia.
Kulinganisha API za usafiri kwa mihimili, si kwa wauzaji
Badilisha jedwali la muuzaji-kwa-kipengele kwa mihimili unayoipima mwenyewe, kutokana na ushahidi uliokusanya wakati wa majaribio. Jedwali lililo hapa chini ndilo ambalo sisi tungetumia. Unaweza kupa mistari uzito tofauti — biashara inayouza hoteli pekee haijali sana utoaji wa tiketi — na ni vyema ubishane nalo kabla ya kulitumia.
| Mhimili | Orodha inauliza nini | Unachopaswa kujua hasa | Jibu dhaifu linasikikaje |
|---|---|---|---|
| Upana | Mashirika ya ndege na hoteli ngapi? | Ngapi zinaweza kutafutwa, kuhifadhiwa NA kutolewa tiketi au kuthibitishwa kupitia API hii, kwenye masoko yako | Namba moja kubwa bila mgawanyo |
| Kina | Kuna endpoint ya kughairi? | Hatua zipi za baada ya kuhifadhi zinafanyika kiotomatiki kwa kila chanzo cha maudhui: void, refund, reissue, kurekebisha jina, huduma za ziada | "Timu yetu ya operesheni hushughulikia hilo" |
| Uaminifu wa bei | Bei ni ya wakati halisi? | Mara ngapi bei wakati wa kuhifadhi inatofautiana na bei wakati wa kutafuta, na API inakujulisha vipi | "Bei huwa live kila mara" |
| Maana ya hitilafu | Hitilafu zimeandikiwa nyaraka? | Kama hitilafu inakuambia uhifadhi uko katika hali gani, si tu kwamba kitu kimeshindwa | Msimbo mmoja wa jumla kwa kila kushindwa |
| Idempotency | — | Kama kurudia ombi la kuhifadhi kunaweza kuunda uhifadhi wa pili | Kimya, kisha "hatujawahi kuona hilo" |
| Supplier of record | — | Mkataba wa nani, namba ya IATA ya nani, tiketi inapita BSP ya nani | "Tunafanya kazi na GDS zote kubwa" |
| Upatikanaji na msaada | Kuna sandbox? | Nani anajibu PNR halisi inapokwama, na kwa haraka kiasi gani | Fomu ya tiketi tu, bila mtu maalum wa kuwasiliana naye |
Mistari miwili kati ya hiyo haina swali lolote kwenye orodha. Si bahati mbaya: ndiyo mistari inayogharimu zaidi inapoharibika, na ndiyo ambayo mawasilisho ya muuzaji yana uwezekano mdogo zaidi wa kuitaja yenyewe.
Upana si kina
Orodha ya mashirika ya ndege ndiyo slaidi inayopotosha zaidi katika wasilisho lolote. Orodha ya mashirika mamia kadhaa inaweza kumaanisha mambo kadhaa tofauti, na moja tu kati yake ndilo unalotaka.
Baadhi ya mashirika hayo hupitia GDS na yanaweza kuhifadhiwa na kutolewa tiketi mwanzo hadi mwisho. Baadhi hupitia viunganisho vya NDC, ambapo kutafuta kunaweza kufanya kazi vizuri lakini huduma baada ya kuhifadhi — mabadiliko, refund ya sehemu, kuongeza mzigo — bado inaweza kuwa ya mkono kwa shirika hilo. Baadhi ni mashirika ya bei nafuu ambayo maudhui yake yamekusanywa kutoka kwa muuzaji mwingine; unaweza kuyaonyesha, wakati mwingine unaweza kuyahifadhi, kisha tiketi inafika kupitia njia usiyoidhibiti, kwa muda ambao huwezi kumuahidi mteja wako. Na baadhi yako kwenye orodha kwa sababu tu nauli fulani iliwahi kurudi kwenye jibu la utafutaji.
Shirika la ndege unaloweza kuonyesha lakini huwezi kulitolea tiketi si upana. Kwa bidhaa ya rejareja ni baya kuliko kutokuwepo kabisa, kwa sababu mteja analichagua, analipa, kisha anasubiri.
Hoteli zina umbo hilo hilo kwa maneno tofauti. Idadi ya hoteli inajumuisha zile ambazo muuzaji ameziweka kwenye ramani na zile ambazo hajaziweka; bei tuli zilizohifadhiwa wiki iliyopita kando ya upatikanaji wa moja kwa moja; vyumba vya allotment vyenye release period kando ya hisa za free-sale. Omba idadi inayoweza kuhifadhiwa moja kwa moja katika miji unayouzia, na uliza jinsi nakala zinazojirudia kati ya wasambazaji wao wenyewe zinavyounganishwa — hoteli moja ikitokea mara tatu kwa bei tatu ni tiketi ya msaada inayosubiri kutokea.
Jaribio la vitendo ni finyu. Andika njia ishirini na miji ishirini ya hoteli inayounda sehemu kubwa ya mauzo yako, na umwombe muuzaji akuonyeshe hizo hizo zikifanya kazi mwanzo hadi mwisho kwenye sandbox: kutafuta, bei, kuhifadhi, kutoa tiketi au kuthibitisha, kughairi. Muuzaji mwenye kina atafanya hivyo bila mzozo. Muuzaji mwenye slaidi tu ataanza kuzungumzia slaidi.
Nini cha kujaribu wakati wa majaribio: njia za hitilafu, si njia laini
Kila sandbox inahifadhi kwa mafanikio tiketi ya daraja la kawaida ya safari moja kwenye njia tulivu. Hiyo ndiyo sababu sandbox ilijengwa. Trafiki yako ya production itatumia sehemu kubwa ya maisha yake kwenye njia nyingine, na majaribio ndiyo nafasi pekee ya bei nafuu ya kuziona.
Tumia majaribio kupitia orodha hii, na uandike kile API ilichorudisha kando ya kile kilichokuwa kweli baadaye:
- Bei kubadilika kati ya kutafuta na kuhifadhi. Je, ombi la kuhifadhi linashindwa, linafanikiwa kwa bei mpya, au linarudisha jibu maalum linalokuomba uthibitishe? UI yako inaweza kutofautisha bila kuchambua maandishi ya ujumbe?
- Ofa iliyoisha muda. Tafuta, subiri zaidi ya muda wa ofa wa muuzaji, kisha hifadhi. Kuisha muda ni hitilafu maalum, au ni hitilafu ile ile ya "msambazaji hapatikani"?
- Imekwisha wakati wa kuhifadhi. Hisa inayopotea kati ya bei na kuhifadhi. Uhifadhi uko katika hali gani, na je, idhini ya malipo inaachiliwa?
- Kurudia baada ya timeout. Tuma ombi la kuhifadhi, kata muunganisho kabla ya jibu, kisha tuma tena. Sasa una PNR moja au mbili? Jaribio hili moja linakuambia mengi kuhusu muuzaji kuliko majaribio mengine yote kwa pamoja.
- Uhifadhi umeundwa, utoaji wa tiketi umeshindwa. Je, API inaweza kuripoti PNR iliyopo lakini haijatolewa tiketi, na inakuambia muda wa mwisho wa kutoa tiketi?
- Kushindwa kwa sehemu. Ombi la hoteli la vyumba vingi ambapo chumba kimoja kinathibitishwa na kingine hakithibitishwi. Safari ya kwenda na kurudi ambapo kwenda na kurudi vinatoka vyanzo tofauti.
- Kughairi nje ya kipindi cha bure. Je, adhabu inatajwa kabla hujathibitisha, au inagunduliwa kwenye ankara?
- Msambazaji kukatika. Muulize muuzaji jinsi ya kuiga hali hiyo. Kama hawezi, uliza wateja wake walijuaje mfumo unavyotenda.
Kwa kila kisa unapima mambo mawili. Kwanza, je, API inakuambia ukweli kuhusu hali ya uhifadhi? Pili, je, msimbo wako unaweza kutenda kwa ukweli huo bila mtu kusoma maandishi huru? API inayoshindwa waziwazi ni rahisi kuishi nayo kuliko ile inayofanikiwa kwa utata.
Tuliandika kwa undani zaidi kuhusu upande wa ndege katika kile ambacho nyaraka za API ya kuhifadhi tiketi za ndege haziandiki, na kuhusu kubuni client kwa wasambazaji wa hoteli walio wazito katika makala ya upatikanaji wa hoteli. Zote mbili ni wenzi wazuri wa mpango wa majaribio.
Maswali yanayofichua aggregator dhaifu
Hakuna ubaya na aggregator. Maudhui mengi ya usafiri huwafikia wauzaji wengi kupitia mmoja wao. Hatari ni ile dhaifu: tabaka linalouza upya API ya tabaka jingine, linaongeza faida, na halimiliki mkataba wa msambazaji wala dawati la operesheni. Kitu kikiharibika, jibu linapaswa kusafiri kampuni mbili juu na kurudi.
Maswali matano yanalitoa hili haraka:
- Nani ni supplier of record wa uhifadhi huu? Unasimama juu ya mkataba wa nani na shirika la ndege au hoteli?
- Tiketi inapita namba ya IATA na BSP ya nani? Jibu likiwa "ya mshirika", uliza nani hupokea ADM sheria ya nauli inapovunjwa.
- Ninapoita cancel, nini kinatokea upande wenu? Ombi la kiotomatiki kwa msambazaji, au foleni inayochukuliwa na mtu?
- Naweza kuona hitilafu ya juu? Tabaka dhaifu huwa linabana kila kushindwa kuwa msimbo mmoja, kwa sababu halielewi kikamilifu hitilafu linazopokea.
- Nampigia nani uhifadhi halisi ukikwama, na yeye anampigia nani? Hesabu hatua.
Hakuna jibu kati ya haya linaloondoa sifa peke yake. Namba ya IATA ya mshirika inaweza kuwa sawa ikiwa mkataba unaeleza wazi nani hubeba debit memo. Kinachojalisha ni muuzaji kujibu kwa usahihi na haraka. Majibu yasiyo wazi hapa ndiyo majibu utakayopata baadaye, kwenye production, saa mbaya zaidi.
Gharama ya kuchagua vibaya
Uunganishaji ni sehemu ya bei nafuu. Sehemu ghali hufika baadaye na hazionekani katika makadirio yoyote.
Hitilafu ya uhifadhi maradufu inamaanisha mteja aliyetozwa mara mbili na PNR unayopaswa kuitafuta na kuighairi kwa mkono, labda baada ya kipindi cha void cha bure kufungwa. Uhifadhi uliofanikiwa juu wakati upande wako ulirekodi kushindwa unamaanisha kiti kilichoshikiliwa, kisha kughairiwa kiotomatiki, na mteja anayeamini amehifadhiwa. Shirika la ndege ulilolionyesha lakini hukuweza kulitolea tiketi linamaanisha refund, kuomba msamaha na mteja asiyerudi. ADM kwa sheria ya nauli iliyovunjwa na njia ya muuzaji inamwangukia mmiliki wa tiketi — hakikisha mapema kama ni wewe.
Kisha kuna gharama ya kuhama. Kila kasoro ya muuzaji unayoikubali — msimbo wa hali wenye maana mbili, sehemu ambayo wakati mwingine ni string — inaishia kwenye modeli yako ya data. Baada ya miaka miwili, uchaguzi wa API si tena uunganishaji unaoweza kubadilishwa kwa sprint moja; ni umbo la jedwali lako la uhifadhi. Hiyo ndiyo sababu halisi ya kulinganisha kwa makini sasa.
API yetu inakaa wapi katika mfumo huu
Tunatoa API za ndege na hoteli. Ufikiaji huanza kwa mazungumzo badala ya ufunguo wa kujihudumia, jambo ambalo baadhi ya developers huona ni la polepole; sababu ni kwamba mazungumzo hayo ndiyo mahali maswali yaliyo hapo juu yanaulizwa pande zote mbili — njia na miji gani unahitaji, maudhui gani utaweza kweli kutoa tiketi au kuthibitisha, na nani hushughulikia nini baada ya kuhifadhi. Kama unafanya ulinganisho, leta orodha hii. Mazungumzo huanzia kwenye ukurasa wa API za usafiri.
Chochote utakachochagua, chagua kutokana na kumbukumbu za majaribio, si wasilisho. Wasilisho linakuambia muuzaji anataka kuwa nini. Njia za hitilafu zinakuambia alivyo kweli.