Bronlaşdırma sistemi API-sində xəta idarəsi: pul itirdən üç nasazlıq

Dəstək bileti cümə axşamı axşam gəlir. Müştəri ödəniş edib, səhifə fırlanıb, sonra ümumi xəta göstərib. Kartdan pul çıxıb. Loqlarınızda təchizatçıya göndərilən və heç vaxt cavab almayan POST görünür. Aviaşirkət yeri saxlayıb? Heç kim deyə bilmir, müştəri isə gözləyir. Yaxşı bronlaşdırma sistemi API-sində xəta idarəsi əsasən belə vəziyyətə heç düşməmək, ya da düşəndə nə edəcəyini dəqiq bilmək işidir.
İnteqrasiya bələdçilərinin çoxu xətaları status kodları kataloqu kimi təqdim edir. Bronlaşdırmada kodlar asan hissədir. Pula başa gələn, sorğunun uğursuz göründüyü, amma dünyanın yenə də dəyişdiyi və ya uğurlu göründüyü, amma dünyanın dəyişmədiyi kiçik hallar toplusudur. Onlardan üçü qalanlardan vacibdir.
Birinci nasazlıq: qiymət axtarışla bron arasında dəyişdi
Axtarış nəticələri təkliflə bağlıdır, müqavilə deyil. Tariflər keşlənir, yerlər təchizatçının satdığı bütün kanallar arasında paylaşılır və saat 14:02-də göstərdiyiniz məbləğ bir neçə dəqiqə sonra köhnələ bilər. Təchizatçı bunu bron yaratma addımında bildirir: bəzən aydın «tarif dəyişdi» cavabı ilə, bəzən də əks halda uğurlu cavabın içində səssizcə fərqli yekun məbləğ qaytararaq.
Təhlükəli olan ikinci variantdır. Kodunuz təsdiqi oxuyub bronu saxlayır və müştərini gördüyü məbləğlə hesablayırsa, fərq sizin marjanızdan, sonra isə ADM-dən çıxır. Qayda sadədir: təchizatçının təsdiqlədiyi yekunu müştərinin qəbul etdiyi yekunla hər dəfə, kodda, ödənişi tutmazdan əvvəl müqayisə edin.
Fərq olduqda nə etmək fərqin böyüklüyündən və onu kimin daşıdığından asılıdır. Valyutalar arasında bir neçə qəpiklik yuvarlaqlaşdırma bir dəfə təyin etdiyiniz toleranstır. Bundan böyük hər şey müştəriyə açıq qəbul düyməsi ilə yeni qiymət kimi qayıdır. Heç vaxt avtomatik uda bilməyin, heç vaxt avtomatik tutmayın.
İkinci nasazlıq: bron var, bilet kəsilməyib
PNR-in olması biletin olması demək deyil. Bir çox axınlar əvvəlcə rezervasiya yaradır, e-bileti isə ayrıca addımda kəsir, arada vaxt limiti olur. Ödəniş keçib, bilet kəsilməsi uğursuz olubsa, müştərinin pulu və öz saatı ilə bitəcək rezervasiya sizdə qalır.
Nasazlıq nadir hallarda səsli olur. Bilet kəsmə çağırışı xəta və ya timeout qaytarır, bron isə verilənlər bazanızın «ödənilib» adlandırdığı vəziyyətdə qalır, təchizatçı isə hələ «saxlanılır» deyir. Bu vaxt biletləmə limiti işləyir və dəstək növbənizdən fərqli olaraq aviaşirkət gözləmir.
Bunu uğur və ya uğursuzluğun variantı kimi yox, ayrıca vəziyyət kimi idarə edin. Bron ən azı bu vəziyyətlərə malik olmalıdır: yaradılıb, saxlanılır, ödəniş tutulub, bilet kəsilir, bilet kəsilib, uğursuz-və-geri qaytarıla bilən. «Ödəniş tutulub, bilet kəsilir» taymer tələb edən vəziyyətdir: bron orada çox qalanda tapşırıq bronu təchizatçıdan yenidən oxuyub qərar verməlidir, insanın fərq etməsini gözləməməlidir. Təchizatçının vaxt limitini bilirsinizsə, qərar ucuzdur, çünki o, geri ödəməzdən əvvəl nə qədər təhlükəsiz təkrar edə biləcəyinizi göstərir.
Üçüncü nasazlıq: nəticəsi məlum olmayan timeout
Bu, cümə axşamı axşamı gələn bilet idi. Sorğunuz getdi; cavab gəlmədi; bağlantı qopdu və ya gateway imtina etdi. Təchizatçı onu tam, qismən və ya ümumiyyətlə emal etməmiş ola bilər.
Vəsvəsə təkrar etməkdir. Bron yaratma çağırışını kor-koranə təkrarlamayın, çünki ikinci cəhd ikinci rezervasiya yarada bilər, dublikat isə real xərcdir: iki yer saxlanılıb, bəlkə iki bilet kəsilib, birinə görə geri ödəmə mübahisəsi.
Təhlükəsiz ardıcıllıq budur: dayan, sonra oxu, sonra qərar ver. Müştəri axınını dürüst «bronunuzu təsdiqləyirik» vəziyyəti ilə dayandırın. Təchizatçı tərəfini çağırışdan əvvəl yaratdığınız istinadla bronu axtararaq oxuyun (buna görə əvvəlcə öz müştəri istinadınızı yaradıb, təchizatçı qəbul edirsə, onu göndərirsiniz). Yalnız sonra qərar verin: tapıldısa, real vəziyyətdən davam edin; təchizatçının öz emal pəncərəsindən sonra tapılmadısa, bir dəfə təhlükəsiz təkrarlaya bilərsiniz.
Təchizatçı sizin istinadınızla axtarışa imkan vermirsə, sərnişin adı, marşrut və tarixlə dar pəncərədə axtarın və uyğunluğu tapılmış sayın. Çirkindir, amma dublikatdan qat-qat ucuzdur.
Razılaşmaya biləcəyiniz qərar cədvəli
| Nə görürsünüz | Nə bilirsiniz | Nə etməli | Nə etməməli |
|---|---|---|---|
| Təchizatçı «tarif dəyişdi» qaytarır | Heç nə bron edilməyib | Yeni yekunu göstərin, razılıq istəyin, yaratmanı yenidən işlədin | Köhnə qiymətlə keçər ümidi ilə yenidən işlətmək |
| Uğur, amma yekun müştərinin qəbul etdiyindən fərqlidir | Yeni qiymətlə bron mövcuddur | Ödənişi saxlayın, müştərinin fikrini soruşun, rədd etsə bronu ləğv edin | Köhnə məbləği tutub fərqi udmaq |
| Ödəniş tutulub, bilet kəsmə çağırışı xəta verir | PNR var, bilet statusu məlum deyil | Bronu yenidən oxuyun, limit daxilində təkrar edin, limitdən sonra geri ödəyin | Bronu uğursuz işarələyib PNR-i unutmaq |
| Yaratmada timeout | Nəticə məlum deyil | Öz istinadınızla axtarın, sonra davam edin və ya bir dəfə təkrarlayın | Dərhal kor təkrar |
| Ləğvdə timeout | Seqmentə görə hələ məsuliyyət daşıya bilərsiniz | Müştəriyə nəsə deməzdən əvvəl statusu yenidən oxuyun | Klik olduğu üçün «ləğv edildi» göstərmək |
Mübahisə edə biləcəyiniz bir sətir: bəzi komandalar müştərini sakitləşdirmək üçün ilk bilet kəsmə xətasında pulu qaytarır. Ucuz biletlərdə bu müdafiə oluna bilər, bahalarda isə pis vərdişdir, çünki bir dəqiqə sonra xilas edə biləcəyiniz tarifi itirə bilərsiniz.
Səhvin sizə neçəyə başa gəldiyi
Hər nasazlığın fərqli hesabı var. Qaçırılmış qiymət dəyişikliyi toxunduğu hər bronda itirilmiş marjadır, çox vaxt yalnız üzləşdirmədə aşkarlanır. Bron-var-bilet-yoxdur halı hava limanına vaxtı keçmiş bronla və kartdan çıxmış pulla gələn müştəridir: eyni anda chargeback və nüfuz problemi. Timeoutdan sonra kor təkrar dublikat rezervasiyadır, aviaşirkətlər dublikatları yoxlayır; onların təkrarlanan nümunəsi ADM-ə düşən şeydir.
Bunların heç biri ekzotik deyil. Bu, demonu həftə sonu işləməyə buraxa biləcəyiniz sistemdən ayıran cazibəsiz boru-kəmər işidir.
Üzləşdirmə tapşırığını lazım olmamışdan qurun
Hər üç nasazlıq eyni cür bitir: sizin bazanız təchizatçınınkı ilə uyğun gəlmir. Ona görə onları müqayisə edən tapşırığı ilk insidentdən sonra yox, əvvəl yazın. Gecə işə salınması minimumdur; keçid vəziyyətindəki hər şey üçün bir neçə dəqiqədən bir daha yaxşıdır. O, saxlanılan, bilet kəsilən və ya məlum olmayan vəziyyətdə ilişib qalmış bronları siyahılayır, təchizatçıdan nə düşündüyünü soruşur və ya qeydi düzəldir, ya da sübutlar əlavə olunmuş bilet açır.
Bron çağırışlarının hər sorğusunu və cavabını, timeoutlar daxil, göndərdiyiniz istinadla saxlayın. Müştəri ödənişə etiraz edəndə həmin loq sizin dəlilinizdir. O, gecikmə söhbətini də dürüst saxlayır: timeoutların aradan qaldırılacaq bug yox, həyat həqiqəti olduğunu anlamaq üçün API gecikməsində nəyi düzəldə biləcəyinizi və nəyi düzəldə bilməyəcəyinizi oxuyun.
Təchizatçı bağlantısını necə qurmaq barədə hələ qərar verirsinizsə, aviabilet bronlaşdırma API inteqrasiyası yazısı bu məqalənin fərz etdiyi çağırışlar ardıcıllığını əhatə edir. Bu vəziyyətlərin bizim aviabilet və otel API-lərimizə necə uyğun gəldiyini müzakirə etmək istəyirsinizsə, giriş söhbətlə başlayır: səyahət API səhifəsinə baxın.