Asosiy mazmunga oʻtish
Blog

Bron qilish tizimi API xatolarini boshqarish: pulga tushadigan uchta nosozlik

Tekravel tahririyati
Sunʼiy intellekt yordamida yozilgan

Qo'llab-quvvatlash tiketi payshanba kechqurun keladi. Mijoz to'lov qildi, sahifa aylanib turdi, keyin umumiy xato ko'rsatdi. Kartadan pul yechildi. Loglaringizda yetkazib beruvchiga yuborilgan va hech qachon javob olmagan POST ko'rinadi. Aviakompaniya joyni ushlab turdimi? Hech kim ayta olmaydi, mijoz esa kutmoqda. Yaxshi bron qilish tizimi API xatolarini boshqarish asosan bunday holatga hech tushmaslik yoki tushganda nima qilishni aniq bilish ishidir.

Integratsiya qo'llanmalarining ko'pchiligi xatolarni status kodlari katalogi sifatida ko'radi. Bron qilishda kodlar eng oson qism. Pulga tushadigani — so'rov muvaffaqiyatsiz ko'ringani bilan dunyo baribir o'zgargan yoki muvaffaqiyatli ko'ringani bilan dunyo o'zgarmagan holatlarning kichik to'plami. Ulardan uchtasi qolganlaridan muhimroq.

Birinchi nosozlik: narx qidiruv va bron oralig'ida o'zgardi

Qidiruv natijalari — taklif, shartnoma emas. Tariflar keshlanadi, joylar yetkazib beruvchi sotadigan barcha kanallar o'rtasida umumiy, 14:02 da ko'rsatgan summangiz esa bir necha daqiqadan keyin eskirishi mumkin. Yetkazib beruvchi bu haqda bron yaratish bosqichida xabar beradi: ba'zan aniq «tarif o'zgardi» javobi bilan, ba'zan esa aks holda muvaffaqiyatli javob ichida jimgina boshqa jami summani qaytarib.

Xavfli bo'lgani ikkinchi variant. Agar kodingiz tasdiqni o'qib, bronni saqlasa va mijozdan u ko'rgan summani yechsa, farq sizning marjangizdan, keyinroq esa ADM dan chiqadi. Qoida oddiy: yetkazib beruvchi tasdiqlagan jamini mijoz qabul qilgan jami bilan har safar, kodda, to'lovni olishdan oldin solishtiring.

Farq bo'lganda nima qilish uning kattaligiga va uni kim ko'tarishiga bog'liq. Valyutalar orasidagi bir necha tiyinlik yaxlitlash bir marta belgilanadigan tolerantlikdir. Undan kattasi mijozga aniq qabul qilish tugmasi bilan yangi narx sifatida qaytadi. Uni hech qachon avtomatik yutmang va hech qachon avtomatik yechmang.

Ikkinchi nosozlik: bron qilindi, lekin chipta berilmadi

PNR ning mavjudligi chiptaning mavjudligi degani emas. Ko'p jarayonlar avval rezervatsiya yaratadi, elektron chiptani esa alohida bosqichda beradi, ularning orasida vaqt chegarasi bor. To'lov o'tib, chipta berish muvaffaqiyatsiz bo'lsa, sizda mijozning puli va o'z soati bilan tugaydigan rezervatsiya qoladi.

Nosozlik kamdan-kam shovqinli bo'ladi. Chipta berish chaqiruvi xato yoki timeout qaytaradi, bron esa bazangiz «to'langan» deb ataydigan holatda qoladi, yetkazib beruvchi hamon «ushlab turilgan» deydi. Shu orada chipta berish muddati ishlab turadi va qo'llab-quvvatlash navbatingizdan farqli o'laroq, aviakompaniya kutmaydi.

Buni muvaffaqiyat yoki muvaffaqiyatsizlik varianti sifatida emas, alohida holat sifatida ko'ring. Bronga kamida shu holatlar kerak: yaratildi, ushlab turilibdi, to'lov yechildi, chipta berilmoqda, chipta berildi, muvaffaqiyatsiz-va-qaytariladigan. «To'lov yechildi, chipta berilmoqda» — taymer kerak bo'lgan holat: bron u yerda juda uzoq tursa, vazifa odam sezishini kutmasdan bronni yetkazib beruvchidan qayta o'qib, qaror qabul qilishi kerak. Yetkazib beruvchining vaqt chegarasini bilsangiz, qaror arzon, chunki u pulni qaytarishdan oldin qancha vaqt xavfsiz takrorlash mumkinligini aytadi.

Uchinchi nosozlik: natijasi noma'lum timeout

Bu — payshanba kechasidagi tiket. So'rovingiz ketdi; javob kelmadi; ulanish uzildi yoki shlyuz taslim bo'ldi. Yetkazib beruvchi uni to'liq, qisman yoki umuman qayta ishlamagan bo'lishi mumkin.

Vasvasa — takrorlash. Bron yaratish chaqiruvini ko'r-ko'rona takrorlamang, chunki ikkinchi urinish ikkinchi rezervatsiyani yaratishi mumkin, dublikat esa haqiqiy xarajat: ikki joy ushlab turilgan, ehtimol ikki chipta berilgan, biri bo'yicha qaytarish nizosi.

Xavfsiz tartib: to'xta, o'qi, keyin hal qil. Mijoz oqimini halol «bronni tasdiqlayapmiz» holati bilan to'xtating. Yetkazib beruvchi tomonini chaqiruvdan oldin o'zingiz yaratgan havola bilan bronni qidirib o'qing (shuning uchun avval o'z mijoz havolangizni yaratib, yetkazib beruvchi qabul qilsa, uni yuborasiz). Faqat shundan keyin hal qiling: topilsa, haqiqiy holatdan davom eting; yetkazib beruvchining o'z ishlov berish oynasidan keyin topilmasa, bir marta xavfsiz takrorlash mumkin.

Yetkazib beruvchi sizning havolangiz bo'yicha qidirishga imkon bermasa, yo'lovchi ismi, yo'nalish va sana bo'yicha tor oynada qidiring va moslikni topilgan deb hisoblang. Xunuk, lekin dublikatdan ancha arzon.

Rozi bo'lmasligingiz mumkin bo'lgan qaror jadvali

Nimani ko'rasizNimani bilasizNima qilish kerakNima qilmaslik kerak
Yetkazib beruvchi «tarif o'zgardi» qaytaradiHech narsa bron qilinmaganYangi jamini ko'rsating, rozilik so'rang, yaratishni qayta ishga tushiringO'tib ketar degan umidda eski narx bilan qayta ishga tushirish
Muvaffaqiyat, lekin jami mijoz qabul qilganidan farq qiladiYangi narxda bron mavjudTo'lovni ushlab turing, mijozdan so'rang, rad etsa bronni bekor qilingEski summani yechib, farqni yutish
To'lov yechildi, chipta berish chaqiruvi xato beradiPNR bor, chipta holati noma'lumBronni qayta o'qing, chegara ichida takrorlang, undan keyin pulni qaytaringBronni muvaffaqiyatsiz deb belgilab, PNR ni unutish
Yaratishda timeoutNatija noma'lumO'z havolangiz bilan qidiring, keyin davom eting yoki bir marta takrorlangDarhol ko'r takrorlash
Bekor qilishda timeoutSegment uchun hamon javobgar bo'lishingiz mumkinMijozga biror narsa aytishdan oldin holatni qayta o'qingBosish bo'lgani uchun «bekor qilindi» ko'rsatish

Bahslashish mumkin bo'lgan bitta qator: ba'zi jamoalar mijozni tinchlantirish uchun chipta berishdagi birinchi xatodayoq pulni qaytaradi. Arzon chiptalarda bu himoya qilinadi, qimmatlarida yomon odat, chunki bir daqiqadan keyin saqlab qolish mumkin bo'lgan tarifni yo'qotishingiz mumkin.

Xato qilish sizga qanchaga tushadi

Har bir nosozlikning hisobi boshqacha. O'tkazib yuborilgan narx o'zgarishi tegilgan har bir bronda yo'qotilgan marja bo'lib, ko'pincha faqat solishtirishda aniqlanadi. Bron-bor-chipta-yo'q holati — muddati o'tgan bron va kartadan yechilgan pul bilan aeroportga kelgan mijoz: bir vaqtning o'zida chargeback va obro' muammosi. Timeoutdan keyingi ko'r takrorlash — takroriy rezervatsiya, aviakompaniyalar dublikatlarni tekshiradi; ularning takrorlanuvchi namunasi ADM ga tushadigan narsadir.

Bularning hech biri ekzotik emas. Bu demoni dam olish kunlariga qoldirish mumkin bo'lgan tizimdan ajratib turadigan jozibasiz quvur ishidir.

Solishtirish vazifasini kerak bo'lishidan oldin quring

Uchala nosozlik ham bir xil tugaydi: sizning bazangiz yetkazib beruvchiniki bilan mos kelmaydi. Shuning uchun ularni solishtiradigan vazifani birinchi voqeadan keyin emas, oldin yozing. Tungi ishga tushirish — minimum; oraliq holatdagi hamma narsa uchun har bir necha daqiqada yaxshiroq. U ushlab turilgan, chipta berilayotgan yoki noma'lum holatda qotib qolgan bronlarni ro'yxatlaydi, yetkazib beruvchidan nima deb o'ylashini so'raydi va yozuvni to'g'rilaydi yoki dalillar biriktirilgan tiket ochadi.

Bron chaqiruvlarining har bir so'rovi va javobini, timeoutlarni ham, yuborgan havolangiz bilan saqlang. Mijoz yechilgan pulga e'tiroz bildirganda, o'sha log sizning dalilingiz. U kechikish haqidagi suhbatni ham halol saqlaydi: timeoutlar yo'q qilinadigan xato emas, hayot haqiqati ekanini tushunish uchun API kechikishida nimani tuzatish mumkin va nimani mumkin emasligini o'qing.

Yetkazib beruvchi ulanishini qanday sozlashni hali hal qilayotgan bo'lsangiz, aviachipta bron qilish API integratsiyasi maqolasi ushbu maqola nazarda tutgan chaqiruvlar tartibini qamrab oladi. Bu holatlar bizning aviachipta va mehmonxona API larimizga qanday mos kelishini muhokama qilmoqchi bo'lsangiz, kirish suhbatdan boshlanadi: sayohat API sahifasini ko'ring.

Tekravel tahririyati

Sayohat texnologiyalari bo'limi

Tekravel sayohat texnologiyalari bo'limi soha vakillari uchun yozadi: agentlik egalari, konsolidatorlar va ularni integratsiya qiluvchi dasturchilar. Har bir maqola chop etilishidan oldin o'zi tasvirlayotgan platformada tekshiriladi.