Asosiy mazmunga oʻtish
Blog

Aviachipta bronlash API integratsiyasi: hujjatda yo‘q gaplar

Tekravel tahririyati
Sunʼiy intellekt yordamida yozilgan

Doskadagi vazifada qisqa yozilgan: "aviachiptalarni qo‘shish". Siz allaqachon to‘lov shlyuzi, yetkazib berish narxlarini hisoblash, balki xarita integratsiyasini ham ulagansiz va boshingizdagi model tushunarli: qidiruv, natijalar, kartadan to‘lov, tamom. Keyin birinchi haqiqiy bron natijalar sahifasidagidan boshqa narx bilan qaytadi, ikkinchisi timeout bilan tugaydi va mijozning joyi bor-yo‘qligini hech kim ayta olmaydi, operatsion bo‘limdan esa kimdir nega bron bor-u, chipta yo‘qligini so‘raydi. Aviachipta bronlash API integratsiyasi tashqaridan oddiy internet-do‘kon checkout’iga o‘xshaydi. Ichkarida esa bu REST’dan ancha oldin loyihalangan tizimlar bilan taqsimlangan tranzaksiya va kutilmagan holatlarning aksariyati aynan shu tafovutdan kelib chiqadi.

Bu matn PNR’ni hech qachon ko‘rmagan dasturchi uchun yozilgan. Gap biror yetkazib beruvchining endpoint’lari haqida emas: nomlar provayderdan provayderga o‘zgaradi, shakl esa o‘zgarmaydi.

Aviachipta bronlash API integratsiyasi: chaqiruvlar ketma-ketligi

Deyarli har qanday aviatsiya API’si, metodlarini qanday nomlashidan qat’i nazar, bir xil to‘rt bosqichdan o‘tadi. Ular orasidagi chegaralarni to‘g‘ri belgilash ishning katta qismi.

BosqichNima qaytaradiNimani saqlash kerakNima buziladi
QidiruvNarxi va shaffof bo‘lmagan taklif yoki tarif kaliti bor marshrutlarUzoq muddatli hech narsa — natijalar tez eskiradiNarxni yakuniy deb hisoblaysiz; kalitning muddati checkout’gacha tugaydi
Narxni tasdiqlashTasdiqlangan narx, tarif qoidalari, bagaj, ba’zan yo‘lovchi uchun majburiy maydonlarTasdiqlangan taklif va uning amal qilish muddatiNarx o‘zgargan; klass sotilib ketgan; qoidalar siz ko‘rsatgandan farq qiladi
BronBron — PNR — bron kodi (record locator) va chipta yozib berish muddati bilanO‘z referensingiz, lokator, muddat, yuborilgan yo‘lovchi ma’lumotlarining aniq nusxasiJavobsiz timeout; takroriy PNR’lar; ismlar rad etiladi
Chipta yozib berishBerilgan elektron chipta raqamlari; pul aynan shu yerda haqiqatan majburiyatga aylanadiHar bir chipta raqami, tegishli yo‘lovchi va segmentga bog‘langan holdaQisman yozib berish; muddat o‘tgani uchun aviakompaniya bronni bekor qilgan

Eng ko‘p bahs uyg‘otadigani uchinchi qator, chunki ko‘p API’lar bron va chipta yozishni bitta chaqiruvda bajarishga imkon beradi. Xohlasangiz, foydalaning. Aviakompaniya dunyosida esa bular baribir alohida narsalar: PNR chiptasiz mavjud bo‘lishi mumkin, chipta esa PNR yaratilgandan keyin muvaffaqiyatsiz bo‘lishi mumkin. Birlashtirilgan endpoint shunchaki biri bajarilib, ikkinchisi bajarilmagan lahzani yashiradi, shuning uchun ma’lumotlar modelingizda bu holat uchun baribir joy bo‘lishi kerak.

Qidiruv nimani qaytarmasligiga ham e’tibor bering: va’dani. Qidiruv natijasi — bu reklama. Narx bosqichi — kotirovka, sotuv esa faqat chipta.

Nega qidiruvdagi narx bron qilinadigan narx emas

Veb-dasturchilar katalog kutadi. Aviakompaniya inventari esa katalog emas. Reys bron klasslariga bo‘lib sotiladi — har biri ma’lum tarifdagi o‘rindiqlar "savati", va aviakompaniya reys to‘lgani sari bu savatlarni uzluksiz ochib-yopib turadi. Qidiruv natijalari biroz orqada qolgan bo‘lishi mumkin bo‘lgan mavjudlik ma’lumotlaridan tez yig‘iladi; foydalanuvchi ikkita pasport ma’lumotini kiritguncha o‘sha reysdagi eng arzon savat yopilib qolishi mumkin. Narx bosqichi ishga tushganda tizim qaytadan so‘raydi va halol javob ba’zan qimmatroq bo‘ladi.

Soliqlar ham o‘z siljishini qo‘shadi. Ular narxlash paytida aniq yo‘lovchilar va marshrut uchun qayta hisoblanadi, bola yoki chaqaloq esa qidiruv taxmin qilgan kattadan boshqacha narxlanadi. Agar vitrinangiz yetkazib beruvchi kotirovka beradigan valyutadan boshqa valyutani ko‘rsatsa, valyuta konvertatsiyasi raqam o‘zgaradigan yana bir joy.

Dizayn uchun xulosa oddiy va ko‘pincha e’tibordan chetda qoladi: hech qachon qidiruv narxi bo‘yicha pul yechmang. To‘lovdan oldin narx bosqichini ishga tushiring, solishtiring, summa o‘zgargan bo‘lsa, yangi raqamni ko‘rsating va tasdiq so‘rang. Qo‘llaydigan har qanday ustamangiz natijalar sahifasidan ko‘chirilmasdan, qayta narxlangan tarif ustida yangidan hisoblanishi kerak — bu agentlik onlayn ustama narx strategiyasini tuzishda bosib o‘tadigan o‘sha mantiq va asos ostidan o‘zgarganda u ham xuddi shunday buziladi.

Idempotentlik va bron paytidagi timeout nimani anglatadi

Bu bo‘limni ikki marta o‘qing.

Bron chaqiruvi timeout bilan tugaganda nima bo‘lganini bilmaysiz. So‘rov umuman yetib bormagan bo‘lishi mumkin. Yetib borib, xato bilan tugagan bo‘lishi mumkin. Yoki — eng og‘riqli holat — yetib borgan, yetkazib beruvchi aviakompaniyada PNR yaratgan, javob esa sizga qaytishda yo‘qolgan. Kodingiz uchun uchala holat bir xil ko‘rinadi. Aviakompaniya uchun esa uchinchisi mijozingiz nomidan o‘rindiqlarni band qilib turgan jonli bron.

Boshqa integratsiyalardan qolgan refleks — qayta urinish. Bu yerda ko‘r-ko‘rona qayta urinish o‘sha reysda o‘sha yo‘lovchilar uchun ikkinchi PNR yaratishi mumkin. Aviakompaniyalar takroriy bronlarni qoidabuzarlik deb hisoblaydi; tashuvchi va agentlik shartnomalariga qarab oqibat bir yoki ikkala bronning avtomatik bekor qilinishidan tortib, ularni yozib bergan tomonga yuboriladigan debet memo — ADM — gacha bo‘ladi. Uni olgan agentlik tizimingiz nega ikki marta bron qilganini bilishni xohlaydi.

Taxminan shu tartibda ishlaydigan usullar:

  • Tashqi chaqiruvdan oldin o‘z bron referensingizni yarating, uni saqlang va API mijoz referensini qabul qiladigan har joyda so‘rov bilan yuboring. API idempotentlik kalitini (idempotency key) qo‘llab-quvvatlasa, undan foydalaning; qo‘llab-quvvatlamasa ham, keyinchalik bronni topish imkonini beradigan narsa — baribir sizning referensingiz.
  • Noma’lum holatni aniq modellashtiring. Kutilmoqda, tasdiqlangan, muvaffaqiyatsiz — va noma’lum. Timeout bronni muvaffaqiyatsizga emas, noma’lumga o‘tkazadi.
  • Noma’lumni takrorlash bilan emas, so‘rash bilan hal qiling. Qayta urinish-urinmaslikni hal qilishdan oldin bronni o‘z referensingiz bo‘yicha oling yoki o‘sha yo‘lovchilar bo‘yicha so‘nggi bronlar ro‘yxatini so‘rang.
  • Solishtirish (reconciliation) vazifasini ishga tushiring: u hali ham noma’lum qolgan hamma narsani yig‘ib, yetkazib beruvchi hisobotidagi bilan solishtirsin, hal qila olmaganini esa taxmin qilish o‘rniga odamlar navbatiga yuborsin.

Chipta yozish paytidagi timeout’lar — o‘sha muammo, faqat endi ishda pul bor. Agar kartadan pulni chipta yozishdan oldin yechsangiz va yozish osilib qolsa, sizda pul to‘lagan, lekin ehtimol chiptasi yo‘q mijoz bor. Agar chiptani pul yechishdan oldin yozsangiz va yechish muvaffaqiyatsiz bo‘lsa, kimdir aviakompaniyaga pulini to‘lashi kerak bo‘lgan hujjatni berib qo‘ygan bo‘lasiz. Avval kartada summani avtorizatsiya qilish, chiptani yozish, so‘ng muvaffaqiyatli bo‘lsa pulni yechish — keng tarqalgan sxema; gap buni production’da kashf qilishda emas, ongli ravishda hal qilishda.

Veb-dasturchilarni hayratda qoldiradigan sayohat tushunchalari

Ularning hech biri qiyin emas. Har biri kimgadir bir haftaga tushgan, chunki u bunday narsa borligini bilmagan.

PNR — chipta emas

PNR — bron yozuvi: yo‘lovchilar, segmentlar, kontaktlar, muddat. Chipta esa yo‘lovchiga uchish huquqini beradigan to‘langan hujjat. Chiptasi yozilmagan PNR chipta yozish muddatida tugaydi va o‘rindiqlar qayta sotuvga chiqadi — ba’zan siz tomondan hech narsa sezilmagan holda.

Ismlarni deyarli o‘zgartirib bo‘lmaydi

Chipta yozilgandan keyin ko‘pchilik tariflar kichik tuzatishdan boshqa ism o‘zgarishiga ruxsat bermaydi, nimani kichik tuzatish deb hisoblash qoidalari esa aviakompaniyaga qarab farq qiladi. Ism sayohat hujjatidagi bilan mos kelishi shart. Familiya va ismlarni alohida yig‘ing, erkin matnli murojaat shaklining ism maydoniga tushib qolishiga yo‘l qo‘ymang va tekshiruvni bron chaqiruvidan keyin emas, oldin qiling.

Yo‘lovchi turlari bezak emas, narxga ta’sir qiladi

Katta, bola va chaqaloq — tarif turlari, qaysi biri qo‘llanishini belgilaydigan yosh esa odatda bron sanasidagi emas, sayohat sanasidagi yosh. Qo‘lda uchadigan chaqaloq odatda o‘rindiq egallamaydi va faqat katta kishi bilan birga ucha oladi. Turni noto‘g‘ri ko‘rsatsangiz, narx bosqichi yo xato beradi, yo noto‘g‘ri tarifni qaytaradi.

Vaqtlar mahalliy, segmentlar esa parvoz qismlari (leg) emas

Uchish va qo‘nish vaqtlari har bir aeroportning mahalliy vaqtida beriladi. Ularni ko‘rsatish uchun foydalanuvchining vaqt mintaqasiga o‘tkazmang va davomiylikni ofsetlarsiz oddiy ayirish bilan hisoblamang. Sayohat segmentlardan iborat; texnik qo‘nishli segment bir nechta parvoz qismidan (leg) iborat. Interfeysingiz va ma’lumotlaringiz ulardan qaysi biri "to‘xtash" hisoblanishida kelishib olishi kerak.

Sotuvdan keyin ham voqealar bo‘ladi

Aviakompaniyalar chiptalar yozilgandan keyin jadvallarni o‘zgartiradi. Chipta yozilgan paytda to‘g‘ri bo‘lgan bron bir necha hafta o‘tib yangi vaqt, yangi reys raqami yoki uzilgan ulanishni ko‘rsatishi mumkin va yetkazib beruvchiga qarab bu haqda bildirishnoma, navbat orqali yoki bronni qayta so‘rab bilib olasiz. Siz bronga qarashni to‘xtatganingizdan keyin ham u o‘zgarishi mumkinligini oldindan rejalashtiring.

Void — qaytarish emas

Chipta berilganidan keyin qisqa vaqt ichida odatda shunday oyna bo‘ladiki, chiptani go‘yo u umuman bo‘lmagandek bekor qilish (void) mumkin. Bu oynadan keyin faqat tarif qoidalari bo‘yicha pulni qaytarish (refund) mumkin va u jarima bilan bo‘lishi yoki umuman hech narsa qaytarmasligi mumkin. Oyna va uning qoidalari yetkazib beruvchi va chipta yozish shartnomasiga tegishli; "bekor qilish" tugmasini qurishdan oldin ularni o‘qing.

Xato qanchaga tushadi

Aviatsiya integratsiyasidagi nosozliklar o‘ziga xos tarzda qimmatga tushadi: ular loglarga emas, odamlarga tushadi. Takroriy bron aviakompaniyaga qo‘ng‘iroqqa va ehtimol agentlik hisobiga qarshi memoga aylanadi. Puli yechilgan, lekin chiptasi yo‘q mijoz pulni qaytarish, shikoyat va chargeback xavfiga aylanadi. Muvaffaqiyatli to‘lovsiz yozilgan chipta kimdir yopishi kerak bo‘lgan aviakompaniya oldidagi qarzga aylanadi. Hech kim ishlov bermagan jadval o‘zgarishi esa ertaroq uchib ketgan reys uchun aeroportda turgan yo‘lovchiga aylanadi.

Bularning hech biri "baxtli yo‘l" testida ko‘rinmaydi. Avval muvaffaqiyatsiz ssenariylarni yozing: bron paytidagi timeout, ko‘tarilgan narx, PNR’dan keyin muvaffaqiyatsiz bo‘lgan chipta, muvaffaqiyatli to‘lovdan keyingi void. Ular hal qilingan bo‘lsa, baxtli yo‘l — ishning oson qismi.

Aviatsiya API’si bilan testlash

Yetkazib beruvchilarning test muhitlari foydali, lekin to‘liq emas. Ular odatda production’dan sokinroq, shuning uchun sotilib ketgan klasslar va narx o‘zgarishlari kamroq uchraydi, ba’zilari esa timeout’larni umuman simulyatsiya qilmaydi. Ulardan chaqiruvlar shakli va validatsiya xatolari uchun foydalaning, keyin production’da haqiqiy bronlar bilan nazoratli sinovni rejalashtiring va ularni oyna ichida void qiling — operatsion bo‘lim buni qilayotganingizdan xabardor bo‘lgan holda.

Umuman integratsiya qilish kerakmi — bu alohida savol. Agar sizga aslida o‘z tizimingizdagi xom inventar emas, vitrina kerak bo‘lsa, tanlov white label yoki o‘z bronlash tizimingizni qurish maqolasida ochib berilgan, xuddi shu mantiq subagentlar uchun B2B portalga ham taalluqli. Inventarni o‘z kodingizda istasangiz, bu platforma aviachipta va mehmonxona API’larini taqdim etadi va kirish o‘z-o‘ziga xizmat kaliti bilan emas, foydalanish ssenariyingiz haqidagi suhbatdan boshlanadi — yuqoridagi savollarning har birini berish uchun ham aynan shu payt to‘g‘ri.

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.