Asosiy mazmunga oʻtish
Blog

Sayohat API taqqoslash: yetkazib beruvchini emas, o'qlarni baholang

Tekravel tahririyati
Sunʼiy intellekt yordamida yozilgan

Uchta tabda uchta yetkazib beruvchining taqdimoti ochiq turibdi. Har birida aviakompaniyalarning uzun ro'yxati yozilgan slayd, mehmonxonalar soni ko'rsatilgan slayd, sandbox, REST va JSON hamda qo'llab-quvvatlash manzili bor. Siz jadval tuzasiz, har bir katakka belgi qo'yasiz va jadval durang bilan tugaydi. Funksiyalar ro'yxati sifatida qilingan sayohat API taqqoslash odatda shunday tugaydi va bu noto'g'ri yakun. Keyingi yilingizni hal qiladigan farqlar faqat ishga tushirilgandan keyin ko'rinadi: yetkazib beruvchida muvaffaqiyatli o'tgan, sizda esa timeout bilan uzilgan bronda; hech kim qayta ishlay olmaydigan pul qaytarishda; ro'yxatda bo'lgan, lekin bu marshrut orqali chiptasini chiqarib bo'lmaydigan aviakompaniyada.

Bu maqola o'sha qarorni qabul qilishi va keyin uni himoya qilishi kerak bo'lgan dasturchi yoki texnik rahbar uchun. U yetkazib beruvchilarni reytingga solmaydi. U sizga taqqoslash o'qlarini, vaqtini nosozliklarga sarflaydigan sinov rejasini va qarshingizdagi tomon yetkazib beruvchimi yoki birovning yetkazib beruvchisini qayta sotuvchimi ekanini tez ko'rsatadigan qisqa savollarni beradi.

Nega funksiyalar ro'yxati doim durang bilan tugaydi

Ro'yxat biror imkoniyat bor-yo'qligini so'raydi. Deyarli har bir sayohat API deyarli har bir qatorga “ha” deya oladi, chunki qatorlar marketing sahifasi darajasida yozilgan: qidiruv, narx, bron, bekor qilish, chipta chiqarish, webhook, sandbox. Ularni ajratadigan savol cancel bor-yo'qligi emas, balki uni parvozdan o'n ikki soat oldin, jarimali tarifda, kontenti uchinchi tomondan kelgan marshrut orqali chiptasi chiqarilgan bronda chaqirsangiz nima bo'lishi. Ro'yxatda buning uchun ustun yo'q.

Ikkinchi muammo ham bor. Ro'yxatni odatda yetkazib beruvchining o'zi to'ldiradi. Siz uning o'zi haqidagi tavsifini baholayapsiz.

Yetkazib beruvchilarga emas, o'qlarga qurilgan sayohat API taqqoslash

“Yetkazib beruvchi × funksiya” to'rini sinov davrida yig'gan dalillaringiz asosida o'zingiz baholaydigan o'qlar bilan almashtiring. Quyidagi jadval biz foydalanadigan jadvaldir. Qatorlarga boshqacha vazn berishingiz mumkin — faqat mehmonxona sotadigan biznes uchun chipta chiqarish kamroq muhim — va uni qabul qilishdan oldin u bilan bahslashib ko'rgan ma'qul.

O'qRo'yxat nimani so'raydiAslida nimani aniqlash kerakZaif javob qanday eshitiladi
QamrovNechta aviakompaniya va mehmonxona?Sizning bozorlaringizda bu API orqali nechtasini qidirish, bron qilish VA chiptasini chiqarish yoki tasdiqlash mumkinTaqsimotsiz bitta katta raqam
ChuqurlikBekor qilish endpointi bormi?Har bir kontent manbai bo'yicha brondan keyingi qaysi amallar avtomatlashtirilgan: void, pul qaytarish, qayta chiqarish, ismni tuzatish, qo'shimcha xizmatlar“Bu bilan operatsion jamoamiz shug'ullanadi”
Narx ishonchliligiNarx real vaqtdami?Bron paytidagi narx qidiruvdagidan qanchalik tez-tez farq qiladi va API buni sizga qanday bildiradi“Narxlar doim jonli”
Xatolar ma'nosiXatolar hujjatlashtirilganmi?Xato faqat nimadir bo'lmaganini emas, bron qaysi holatda ekanini aytadimiHar qanday nosozlik uchun bitta umumiy kod
Idempotentlik—Takrorlangan bron chaqiruvi ikkinchi bron yaratishi mumkinmiSukut, keyin “bunday holni ko'rmaganmiz”
Shartnoma bo'yicha yetkazib beruvchi—Chipta kimning shartnomasi, kimning IATA raqami, kimning BSP'si orqali o'tadi“Barcha yirik GDS'lar bilan ishlaymiz”
Kirish va qo'llab-quvvatlashSandbox bormi?Jonli PNR qotib qolganda kim javob beradi va qanchalik tezMurojaat formasi va ismi bor birorta ham aloqa shaxsi yo'q

Bu qatorlardan ikkitasining ro'yxatda umuman savoli yo'q. Bu tasodif emas: ish buzilganda eng qimmatga tushadigan va savdo taqdimoti o'z-o'zidan eng kam tilga oladigan qatorlar aynan shular.

Qamrov — bu chuqurlik emas

Aviakompaniyalar ro'yxati har qanday taqdimotning eng chalg'ituvchi slaydi. Bir necha yuz tashuvchidan iborat ro'yxat turli narsalarni anglatishi mumkin va ulardan faqat bittasi sizga kerak bo'lgani.

Bu tashuvchilarning bir qismi GDS orqali keladi va boshidan oxirigacha bron qilinib, chiptasi chiqarilishi mumkin. Bir qismi NDC ulanishlari orqali keladi; bu yerda qidiruv yaxshi ishlashi mumkin, lekin brondan keyingi xizmat — o'zgartirishlar, qisman pul qaytarish, bagaj qo'shish — o'sha aviakompaniya uchun hali ham qo'lda bo'lishi mumkin. Yana bir qismi kontenti boshqa qayta sotuvchidan yig'iladigan lowcost'lar: ularni ko'rsatishingiz, ba'zan bron qilishingiz mumkin, keyin esa chipta siz nazorat qilmaydigan yo'l bilan, mijozga va'da bera olmaydigan muddatda keladi. Ba'zilari esa qachondir biror tarif qidiruv javobida paydo bo'lgani uchun ro'yxatda turibdi.

Ko'rsata oladigan, lekin chiptasini chiqara olmaydigan tashuvchingiz qamrov emas. Chakana mahsulot uchun bu yo'qlikdan ham yomon: mijoz uni tanlaydi, to'laydi va kutadi.

Mehmonxonalarning shakli ham xuddi shunday, faqat so'zlar boshqa. Obyektlar soniga yetkazib beruvchi moslashtirgan va moslashtirmagan mehmonxonalar; o'tgan hafta keshga yozilgan statik narxlar bilan jonli mavjudlik yonma-yon; release muddati bor allotment xonalari bilan erkin sotuv fondi kiradi. Siz sotadigan shaharlarda jonli bron qilish mumkin bo'lgan obyektlar sonini so'rang va ularning o'z yetkazib beruvchilari o'rtasidagi dublikatlar qanday birlashtirilishini bilib oling: bitta mehmonxonaning uch narxda uch marta chiqishi — kutib turgan qo'llab-quvvatlash murojaati.

Amaliy tekshiruv tor. Hajmingizning katta qismini beradigan yigirmata marshrut va yigirmata mehmonxona shahrini yozib chiqing — masalan, Toshkent–Dubay, Toshkent–Istanbul, Dubay va Antalyadagi mehmonxonalar — va yetkazib beruvchidan aynan ularni sandbox'da boshidan oxirigacha ishlayotgan holda ko'rsatishni so'rang: qidiruv, narx, bron, chipta chiqarish yoki tasdiqlash, bekor qilish. Chuqurligi bor yetkazib beruvchi buni ortiqcha gapsiz qiladi. Faqat slaydi bori esa slayd haqida gapira boshlaydi.

Sinov davrida nimani tekshirish kerak: baxtli yo'llarni emas, xato yo'llarini

Har qanday sandbox tinch marshrutda ekonom klassdagi bir tomonlama chiptani muvaffaqiyatli bron qiladi. U aynan shuni namoyish qilish uchun qurilgan. Sizning ishlab chiqarish trafigingiz hayotining sezilarli qismini boshqa yo'llarda o'tkazadi va sinov davri ularni ko'rish uchun yagona arzon payt.

Sinovda ushbu ro'yxatdan o'ting va API nima qaytarganini keyin aslida haqiqat bo'lib chiqqan narsa bilan yonma-yon yozib boring:

  • Qidiruv va bron orasida narx o'zgarishi. Bron chaqiruvi muvaffaqiyatsiz tugaydimi, yangi narxda o'tadimi yoki tasdiq so'raydigan alohida javob qaytaradimi? Interfeysingiz xabar matnini tahlil qilmasdan bu holatlarni farqlay oladimi?
  • Muddati o'tgan taklif. Qidiring, yetkazib beruvchi aytgan taklif muddatidan ko'proq kuting, keyin bron qiling. Muddat o'tishi alohida xatomi yoki “yetkazib beruvchi mavjud emas” bilan bir xil xatomi?
  • Bron paytida sotilib ketgan. Narx va bron orasida yo'qolgan fond. Bron qaysi holatda va to'lov bloki bo'shatiladimi?
  • Timeout'dan keyin takrorlash. Bron so'rovini yuboring, javobdan oldin ulanishni uzing va uni qayta yuboring. Endi sizda bitta PNR bormi yoki ikkita? Shu bitta test yetkazib beruvchi haqida sinovning qolgan barcha qismidan ko'proq narsani aytadi.
  • Bron yaratilgan, chipta chiqmagan. API mavjud, lekin chiptasi chiqarilmagan PNR haqida xabar bera oladimi va chipta chiqarish muddatini aytadimi?
  • Qisman nosozlik. Bir nechta xonali mehmonxona so'rovi: biri tasdiqlanadi, boshqasi yo'q. Borish-qaytish parvozi: segmentlar turli manbalardan keladi.
  • Bepul oynadan tashqari bekor qilish. Jarima tasdiqdan oldin aytiladimi yoki uni hisob-fakturada ko'rasizmi?
  • Yetkazib beruvchining ishlamay qolishi. Yetkazib beruvchidan buni qanday simulyatsiya qilishni so'rang. Bilmasa, mijozlari tizim o'shanda o'zini qanday tutishini qanday bilib olganini so'rang.

Har bir holatda ikki narsani baholaysiz. Birinchisi: API bron holati haqida sizga haqiqatni aytadimi? Ikkinchisi: kodingiz erkin matnni o'qiydigan odamsiz shu haqiqat asosida harakat qila oladimi? Aniq muvaffaqiyatsiz bo'ladigan API bilan yashash noaniq muvaffaqiyatli bo'ladigan API bilan yashashdan osonroq.

Parvoz tomoni haqida aviachipta bron API hujjatlari aytmaydigan narsalar maqolasida, sekin mehmonxona yetkazib beruvchilari uchun klient loyihalash haqida esa mehmonxona mavjudligi haqidagi maqolada batafsilroq yozganmiz. Ikkalasi ham sinov rejasiga yaxshi qo'shimcha.

Yupqa agregatorni fosh qiladigan savollar

Agregatorda yomon narsa yo'q. Sayohat kontentining katta qismi sotuvchilarning ko'pchiligiga aynan ulardan biri orqali yetib boradi. Xavf yupqa agregatorda: boshqa qatlamning API'sini qayta sotadigan, ustiga marja qo'shadigan, lekin na yetkazib beruvchi shartnomasiga, na operatsion bo'limga ega bo'lgan qatlam. Biror narsa buzilsa, javob ikki kompaniya yuqoriga borib, qaytib kelishi kerak.

Besh savol buni tez yuzaga chiqaradi:

  1. Bu bron bo'yicha shartnoma yetkazib beruvchisi kim? U aviakompaniya yoki mehmonxona bilan kimning shartnomasiga tayanadi?
  2. Chipta kimning IATA raqami va kimning BSP'si orqali o'tadi? Javob “hamkorniki” bo'lsa, tarif qoidasi buzilganda ADM'ni kim olishini so'rang.
  3. Men cancel chaqirganimda sizda nima sodir bo'ladi? Yetkazib beruvchiga avtomatik chaqiruvmi yoki odam oladigan navbatmi?
  4. Yuqori manbadagi xatoni ko'ra olamanmi? Yupqa qatlam odatda har qanday nosozlikni bitta kodga siqib qo'yadi, chunki o'zi olgan xatolarni to'liq tushunmaydi.
  5. Qotib qolgan jonli bron bo'yicha kimga qo'ng'iroq qilaman va ular kimga qo'ng'iroq qiladi? Bo'g'inlarni sanang.

Bu javoblarning hech biri o'z-o'zidan diskvalifikatsiya qilmaydi. Agar shartnomada debet notani kim ko'tarishi aniq yozilgan bo'lsa, hamkorning IATA raqami ham joiz bo'lishi mumkin. Muhimi — yetkazib beruvchi aniq va tez javob berishi. Bugungi noaniq javoblar keyinchalik, ishlab chiqarishda, yomonroq soatda oladigan javoblaringizdir.

Noto'g'ri tanlov sizga qanchaga tushadi

Integratsiya — arzon qism. Qimmat qismlar keyin keladi va hech qanday smetada ko'rinmaydi.

Ikki marta bron xatosi — ikki marta pul yechilgan mijoz va qo'lda topib bekor qilinishi kerak bo'lgan PNR, ehtimol bepul void oynasi yopilganidan keyin. Manbada muvaffaqiyatli o'tgan, sizda esa xato deb yozilgan bron — ushlab turilgan, keyin avtomatik bekor qilingan o'rin va bron qilganiga ishongan mijoz. Ko'rsatilgan, lekin chiptasi chiqarib bo'lmagan tashuvchi — pul qaytarish, uzr va qaytib kelmaydigan mijoz. Yetkazib beruvchi marshruti buzgan tarif qoidasi uchun ADM chipta egasiga keladi — bu siz ekansizmi yoki yo'qmi, oldindan aniqlab oling.

Yana o'tish xarajati bor. Siz singdirgan har bir yetkazib beruvchi g'alatiligi — ikki ma'noli status kodi, ba'zan matn bo'ladigan maydon — ma'lumotlar modelingizga tushadi. Ikki yildan keyin API tanlovi endi bir sprintda almashtirsa bo'ladigan integratsiya emas; bu sizning bronlar jadvalingiz shakli. Hozir diqqat bilan taqqoslashning haqiqiy sababi shu.

Bizning API bu usulga qanday mos keladi

Biz aviachipta va mehmonxona API'larini taqdim etamiz. Kirish self-service kalit bilan emas, suhbat bilan boshlanadi; ba'zi dasturchilar buni sekin deb biladi. Sababi shundaki, yuqoridagi savollar aynan shu suhbatda ikki tomonga beriladi — sizga qaysi marshrut va shaharlar kerak, qaysi kontentning chiptasini haqiqatan chiqara yoki tasdiqlay olasiz, brondan keyin nimaga kim javob beradi. Agar taqqoslash o'tkazayotgan bo'lsangiz, bu ro'yxatni o'zingiz bilan olib keling. Bu suhbat sayohat API'lari sahifasida boshlanadi.

Nimani tanlasangiz ham, taqdimotga qarab emas, sinov jurnaliga qarab tanlang. Taqdimot yetkazib beruvchi kim bo'lishni xohlashini aytadi. Xato yo'llari esa uning kimligini.

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.