Mehmonxona boʻsh xonalari API: sekin taʼminotchilar uchun

Vazifa odatda beozor koʻrinadi. “Bron sahifasiga mehmonxona qidiruvini qoʻshish kerak — taʼminotchi mehmonxona boʻsh xonalari API taqdim etdi, sandbox bor, bir sprintda bitadi.” Hujjatlarni oʻqiysiz, Dubayga ikki kattalar uchun uch kechaga soʻrov yuborasiz — javob keladi. Keyin xuddi shu soʻrovni obyektlari koʻproq shaharga yuborasiz va uzoq, noqulay vaqt davomida hech narsa kelmaydi. Nihoyat kelganda esa, bu JSON parseringizni hayotning maʼnosi haqida oʻylantirib qoʻyadigan darajada katta hujjat boʻlib chiqadi.
Aynan shu lahzada ishning shakli oʻzgaradi. Mehmonxonada boʻsh xona qidirish — oddiy lookup emas. Bu tarqatish (fan-out): foydalanuvchingizning bitta savoli koʻplab taʼminotchilarga beriladigan koʻp savolga aylanadi, ularning har biri esa oʻz tezligida, oʻz atamalarida, “xona” nima ekanligi haqidagi oʻz tushunchasi bilan javob beradi. Siz yaratadigan klient bu tarqatish hali yakunlanmagan paytda ham foydali boʻlib qolishi kerak. Ushbu maqola aynan shunday klientni loyihalash haqida. U REST va JSON bilan yaxshi tanish, lekin hali hech qachon mehmonxonaga mehmonning qaytarilmaydigan tarifi nega bepul bekor qilish sifatida koʻrsatilganini tushuntirishga majbur boʻlmagan dasturchi uchun yozilgan.
Nega mehmonxona boʻsh xonalari API siz oʻrgangan endpointlardan sekinroq
Tashqaridan qaraganda aviachipta qidiruvi va mehmonxona qidiruvi oʻxshash: soʻrov ketadi, narxlangan variantlar qaytadi. Ichkarida esa bular bir xil muammo emas. Agar aviachipta bronlash API integratsiyasi aslida nimalarni oʻz ichiga olishi haqidagi yozuvlarimizni oʻqigan boʻlsangiz, qidirgan narxingiz har doim ham bron qiladigan narxingiz emasligini bilasiz. Mehmonxonalar buning ustiga ikkinchi qiyinchilikni qoʻshadi: hajm.
Bitta shaharda yuzlab obyekt boʻlishi mumkin. Har bir obyekt bir nechta xona turini sotadi. Har bir xona turi bir nechta tarif rejasi bilan sotiladi — nonushta bilan yoki usiz, qaytariladigan, qaytarilmaydigan, aʼzolar uchun tarif, paket tarif. Har bir tarif rejasi bir nechta taʼminotchidan kelishi mumkin: bedbank, channel manager, toʻgʻridan-toʻgʻri shartnoma, bitta mehmonxonadagi allotment’i boshqalarnikidan yaxshiroq boʻlgani uchun shartnoma tuzilgan ulgurji sotuvchi. Bularning hammasini koʻpaytiring — “oddiy” qidiruv nomlar va ID’lar boʻyicha bir-biri bilan kelisha olmaydigan bir necha manbadan yigʻilgan katta daraxtga aylanadi.
Shuning uchun sekin qism kamdan-kam hollardagina sizning kodingiz boʻladi. Odatda bu — kutishni oʻzingiz tanlagan eng sekin taʼminotchi.
Bosqichma-bosqich natija yoki toʻliq javob: ongli tanlang
Mehmonxona qidiruvi natijalarini qaytarishning ikkita halol yoʻli bor, integratsiyalarning aksariyati esa oxir-oqibat ularning oʻrtasidagi noqulay bir joyda qolib ketadi.
Hammasini kutish. Backend soʻrovni tarqatadi, har bir taʼminotchi javob berguncha yoki taymautga tushguncha kutadi, natijalarni birlashtiradi, takrorlarni olib tashlaydi, saralaydi va bitta toʻliq roʻyxat qaytaradi. Natija toza: bitta soʻrov, bitta javob, barcha narxlar stol ustida boʻlgani uchun ularni solishtirish mumkin. Buning bahosi — foydalanuvchingiz eng sekin taʼminotchi qancha vaqt olsa, shuncha vaqt aylanayotgan yuklanish belgisiga tikilib oʻtiradi. Har safar.
Borini oqim bilan berish. Backend tarqatishni boshlaydi va darhol qidiruv identifikatorini (handle) qaytaradi. Klient shu handle’ni navbatma-navbat soʻrab turadi yoki oqimni ochiq ushlab turadi va taʼminotchilar javob bergan sari natijalarni toʻp-toʻp boʻlib oladi. Birinchi mehmonxonalar tez paydo boʻladi. Buning bahosi — qolgan hamma joydagi murakkablik: foydalanuvchi oʻqiyotganda roʻyxat tartibi oʻzgaradi, “eng arzon” belgisi joyini almashtirishi mumkin, bir taʼminotchidan chiqqan mehmonxona esa keyinroq boshqasidan arzonroq tarif olishi ehtimoli bor.
Agar interfeysingiz inson oldidagi qidiruv sahifasi boʻlsa, bosqichma-bosqich natija deyarli har doim toʻgʻri: odam koʻzdan kechiryapti, paketli vazifa ishga tushirayotgani yoʻq, ishlayotgani koʻrinib turgan sahifa esa jimgina oʻylab turgan sahifadan ancha yaxshi. Agar isteʼmolchingiz boshqa mashina boʻlsa — tariflarni solishtiruvchi vazifa yoki bitta aniq javob kerak boʻlgan korporativ bron vositasi — kutish koʻpincha ham soddaroq, ham toʻgʻri.
Qaysi birini tanlamang, bosqichma-bosqich ishlaydigan klientni tartibda saqlaydigan uchta qoida bor:
- Har bir toʻp butun qidiruvning yakunlanish holatini olib yuradi, shunda klient “hozircha boshqa natija yoʻq” bilan “endi hech qachon natija boʻlmaydi”ni farqlay oladi.
- Natijalar serverda roʻyxat oxiriga shunchaki qoʻshilmaydi, barqaror mehmonxona kaliti boʻyicha birlashtiriladi. Ikki kartochka bitta bino ekanini klient oʻzi aniqlashi shart boʻlmasligi kerak.
- Narx boʻyicha saralash qidiruv yakunlanguncha vaqtinchalik va interfeys buni ochiq aytadi. Foydalanuvchilar joyiga tushib borayotgan roʻyxatni kechiradi; keyin notoʻgʻri boʻlib chiqqan “eng past narx” belgisini kechirmaydi.
Xonalar va tarif rejalarini aralashtirmasdan modellashtirish
Mehmonxona integratsiyalarining aksariyati aynan shu yerda jimgina barbod boʻladi, bu muvaffaqiyatsizlik esa oylar oʻtib bag haqidagi hisobot sifatida emas, qoʻllab-quvvatlash xizmatiga kelgan murojaat sifatida yuzaga chiqadi.
Eng jozibali model — tekis model: mehmonxonada takliflar roʻyxati bor, har bir taklifda xona nomi va narx. Ekranda chiroyli koʻrinadi. Keyin bir taʼminotchi aniq bir xil xona uchun “Deluxe King” va “Deluxe Room, 1 King Bed” qaytaradi, boshqasi haqiqatan ham ikki xil xonaga (biri shahar manzarali, biri manzarasiz) bir xil nom beradi, uchinchisi esa qolganlarning hammasi butun turish muddati uchun narx berganda, bir kechalik narxni qaytaradi. Tekis roʻyxat bularning qaysi biriga qarab turganingizni ayta olmaydi. U ularni shunchaki koʻrsatadi.
Haqiqiy taʼminotchilar bilan toʻqnashuvdan omon chiqadigan modelda kamida toʻrtta daraja boʻladi va ular bir-biridan alohida saqlanadi:
| Daraja | Nimani saqlaydi | Qochish kerak boʻlgan xato |
|---|---|---|
| Mehmonxona | Har bir taʼminotchi kodiga bogʻlangan oʻzingizning barqaror ID’ingiz | Taʼminotchining mehmonxona ID’sini asosiy kalit sifatida ishlatish |
| Xona | Sigʻim, karavot konfiguratsiyasi, taʼminotchining xona matni soʻzma-soʻz saqlangan holda | Ikki xil xona bittaga qoʻshilib ketguncha xona nomlarini “tozalash” |
| Tarif rejasi | Ovqatlanish turi, qaytarilishi, toʻlov turi, qaysi taʼminotchidan kelgani | Nonushta yoki qaytarilishni xona nomining bir qismi deb hisoblash |
| Narx | Butun turish muddati uchun jami summa, valyuta, ichiga qaysi soliq va yigʻimlar kirgani va qaysilari mehmonxonada toʻlanishi | Bir kechalik summani butun muddat summalari yoniga qoʻyish yoki kelganda toʻlanadigan yigʻimlarni yashirish |
Chegaralar qayerdan oʻtishi bilan kelishmasligingiz mumkin — baʼzi jamoalar sigʻimni alohida darajaga ajratadi, bu bir necha xonali bronlarni sota boshlaganingizda juda oʻrinli. Lekin interfeys faqat ikkitasini koʻrsatgani uchun darajalarni birlashtirib yuborish mumkin emas. Interfeys koʻrsatish paytida tekislashi mumkin. Maʼlumotlar esa tekislanmasligi kerak.
Bir tafsilot alohida gapga loyiq: nimani normallashtirmang, taʼminotchining xona haqidagi asl tavsifini yonida saqlang. Mehmon kelib, unga vaucherdagidan boshqa xona berilsa, har kim birinchi boʻlib taʼminotchi aslida nima yuborganini soʻraydi.
Bekor qilish siyosati — paragraf emas, maʼlumot
Koʻplab taʼminotchilar bekor qilish shartlarini erkin matn sifatida qaytaradi: “Kelishdan 3 kun oldingacha bepul bekor qilish, undan keyin 1 kecha jarima.” Shu qatorni ekranga chiqarib, davom etib ketish juda jozibali.
Bunday qilmang. Matnni solishtirib, saralab, filtrlab yoki ijro ettirib boʻlmaydi. Foydalanuvchingiz faqat qaytariladigan tariflarni filtrlamoqchi. Moliya boʻlimi ertaga qaysi bronlar qaytarilmaydigan boʻlib qolishini bilmoqchi, shunda agentlik muddat oʻtmasidan mijoz bilan bogʻlana oladi. Bron qilingandan keyingi jarayon mijozga bekor qilish tugmasini bosgan zahoti undan aniq qancha ushlanishini aytishi kerak. Bularning hech biri bitta gap ustida ishlamaydi.
Har bir siyosatni jarima oynalarining tartiblangan roʻyxati sifatida modellashtiring: shu lahzadan boshlab falon lahzagacha ushlanadigan summa mana bu (yoki turish narxining shuncha ulushi, yoki shuncha kecha). Chegaralar — vaqt mintaqasi koʻrsatilgan timestamp’lar, bu mintaqa esa serveringizniki ham, foydalanuvchiniki ham emas, mehmonxonaniki, chunki “kelishdan 3 kun oldin” kimning yarim tunidan sanashingizga qarab turli lahzani anglatadi. Taʼminotchining asl matnini tuzilmalangan variant yonida saqlang, ekranda tuzilmalanganini koʻrsating, ular orasidagi nomuvofiqlikni esa yashiriladigan emas, tekshiriladigan narsa deb biling.
Siyosatni faqat qidiruv paytida emas, bron paytida ham qayta tekshiring. Siyosatlar bu ikki chaqiruv orasida hamma kutganidan koʻra tez-tez oʻzgaradi.
Xatoning haqiqiy narxi
Sekin qidiruv konversiyani yoʻqotadi — bu yomon, lekin koʻzga tashlanadi: kimdir albatta shikoyat qiladi. Qimmatga tushadiganlari — jimjit muvaffaqiyatsizliklar.
Taʼminotchi qaytarilmaydigan deb hisoblaydigan tarifni qaytariladigan qilib koʻrsatish — qoʻlida skrinshoti bor mijoz bilan nizo, jarimani esa odatda agentlikning oʻzi toʻlaydi. Bir kechalik narxni butun muddat summasi sifatida koʻrsatish buxgalteriyadagi kimdir payqaguncha xonalarni tannarxidan arzon sotadi. Boshqa xona bilan birlashib ketgan xona toʻrt kishilik oilani ikki kishiga moʻljallangan xonaga joʻnatadi. Hech qachon koʻrsatilmagan, mehmonxonada toʻlanadigan yigʻimlar besh yulduzli sharhni chargeback’ga aylantiradi. Bularning har biri — birinchi sprintda, odatda “keyin tartibga keltiramiz” degan bahona bilan qabul qilingan modellashtirish qarori.
Keshlash: nimani saqlash mumkin va nimani mumkin emas
Mehmonxona API’sini integratsiya qiladigan har bir jamoa ertami-kechmi qidiruvni tezroq va arzonroq qilish uchun natijalarni keshlash mumkinmi, deb soʻraydi. Javob: ha, baʼzi narsalar uchun, va ular orasidagi chegara har qanday unumdorlik koʻrsatkichidan muhimroq.
Statik kontent — mehmonxona nomlari, manzillar, koordinatalar, fotosuratlar, qulayliklar roʻyxati, xona tavsiflari — kamdan-kam oʻzgaradi va aynan uni oʻz omboringizda dadil keshlash kerak. Uni qanday saqlash va koʻrsatish mumkinligi haqida taʼminotchi shartlarini tekshiring; baʼzi litsenziyalar buni cheklaydi. Uni har bir qidiruvda jonli olish hech qanday foydasiz sekinlashtiradi.
Jonli tariflar va boʻsh xonalar — boshqa masala. Keshlangan narx — taʼminotchi qancha soʻrashi haqidagi taxmin xolos, taʼminotchilar esa sizning taxminlaringizni tan olmaydi. Qidiruv natijalarini qisqa muddatga keshlash sahifani koʻrsatish uchun maqbul boʻlishi mumkin — faqat har bir bron yoʻli pul olishdan oldin narxni taʼminotchidan qayta olsa va interfeys oʻzgargan narxni xato emas, oddiy natija deb qabul qilsa. Baʼzi taʼminotchilar qidiruvlar sonini bronlar soniga nisbatan cheklaydi; haqiqiy trafigingizni ulardan yashiradigan agressiv keshlash ishonib boʻladigan boʻshliq emas.
Majburiyatni bildiradigan hech narsani hech qachon keshlamang: ushlab turilgan narx tokenini, bron raqamini, bekor qilish boʻyicha hisob-kitobni. Ular bitta foydalanuvchiga va bitta lahzaga tegishli.
“Tayyor” deyishdan oldin
Haqiqiy bronlarni qabul qilishdan oldin oʻz integratsiyangizda oʻtkazishga arziydigan qisqa tekshiruv:
- Qidiruv yakunlanish holatini qaytaradi va klient undan oldin va keyin turlicha harakat qiladi.
- Mehmonxonalar oʻzingizning ID’ingiz bilan kalitlanadi, har bir taʼminotchi kodi unga bogʻlangan.
- Ekranda nima koʻrsatilmasin, maʼlumotlaringizda xona, tarif rejasi va narx alohida obyektlar.
- Har bir narx bir kecha uchunmi yoki butun muddat uchunmi va kelganda nima toʻlanishini aytadi.
- Bekor qilish siyosatlari mehmonxona vaqt mintaqasidagi vaqtga bogʻlangan jarima oynalari sifatida saqlanadi, asl matn ham qoladi.
- Bron yoʻli kimdandir pul olishdan oldin narxni qayta oladi va siyosatni qayta oʻqiydi.
- Majburiyatni bildiradigan hech narsa hech qachon keshdan berilmaydi.
Agar bularning hammasini alohida taʼminotchilar bilan oʻzingiz qurish bilan bu muammolarga allaqachon duch kelgan platformadan boshlashni solishtirayotgan boʻlsangiz, shartnoma tomoni koddan kam muhim emas — mehmonxona konsolidatori shartnomalari va bedbank tariflari haqidagi maqolamiz nimani soʻrash kerakligini koʻrib chiqadi. Bizning aviachipta va mehmonxona API’larimiz mustaqil olinadigan kalit orqali emas, suhbat orqali ochiladi; agar aynan shu yoʻlni oʻrganmoqchi boʻlsangiz, bu suhbatni travel APIs sahifasida boshlang.
Tarqatish hech qachon yoʻqolmaydi. Yaxshi klient shunchaki u yoʻqdek koʻrsatishga urinmaydi.