Dubayda API integratsiya kompaniyasini yollashdan oldin

Stolda uchta tijorat taklifi turibdi. Har bir integratsiya kompaniyasining turizm saytlaridan iborat portfoliosi bor, har biri "saytingizga aviachipta API ulab berish"ni va'da qiladi, eng arzoni esa keyingi haftadayoq ishni boshlay oladi. Siz Deyrada olti kishilik agentlik yuritasiz, korporativ mijozlaringiz barqaror, yetkazib beruvchining ekstranetidan tariflarni WhatsApp xabarlariga ko'chiravering, charchab bo'ldingiz. Dubaydagi eng malakali ko'ringan API integratsiya kompaniyasini tanlash butun qarorning o'zi bo'lib tuyuladi.
Bu qarorning taxminan uchdan biri, xolos. Sayt sotadimi-yo'qmi, shuni belgilaydigan narsalar uchta taklifning hech birida yo'q, chunki ular kod emas. Savol shunda: yetkazib beruvchi shartnomani kim bilan imzolagan, chiptalar kimning nomidan rasmiylashtiriladi, bron va chipta rasmiylashtirish oralig'ida pul qayerda turadi, mijoz voz kechganda pulni qaytarish bilan kim shug'ullanadi. Integrator bularning hammasini bir-biriga ulay oladi. Ammo sizning o'rningizga ulardan biri bo'la olmaydi.
Bu matn texnik topshiriqqa imzo chekadigan egasi uchun yozilgan, uni o'qiydigan dasturchi uchun emas.
Dubaydagi API integratsiya kompaniyasi nima bera oladi, nima bera olmaydi
Integratsiya kompaniyasi yetkazib beruvchining API'si va sizning saytingiz orasidagi kodni yozadi: qidiruv formasi, joylar bor-yo'qligini so'raydigan so'rov, to'lovdan oldin narxni tekshirish, bron so'rovi, natijani ko'rsatadigan ekranlar, ish hajmida yozilgan bo'lsa — bekor qilish va pulni qaytarish so'rovlari ham. Yaxshi kompaniyalar zerikarli, lekin muhim qismlarni ham o'z zimmasiga oladi: yetkazib beruvchi o'z vaqtida javob bermasa, qayta urinish; muvaffaqiyatsiz bronni kuzatishga imkon beradigan loglar; ishchi muhit kabi ishlaydigan test muhiti.
U sizga bera olmaydigan narsa — o'sha kodning narigi tomonidagi hamma narsa. Bitta qator yozilishidan oldin agentlikka kerak:
- agentlikning o'z nomiga ochilgan yetkazib beruvchi hisobi, API ruxsati aynan shu hisobga berilgan bo'lishi kerak;
- chipta rasmiylashtirish huquqi — yo o'z akkreditatsiyangiz, yo sizning nomingizdan chipta chiqaradigan consolidator;
- o'sha yetkazib beruvchi bilan moliyaviy kelishuv: depozit, kredit liniyasi yoki karta to'lovlarini to'g'ridan-to'g'ri o'tkazish;
- chiptadan keyingi ishni (void, pulni qaytarish, qayta rasmiylashtirish, jadval o'zgarishlari) bajaradigan kimdir — API orqali, bo'lmasa qo'lda.
"Yetkazib beruvchi tomonini o'zimiz hal qilamiz" degan integrator odatda o'z hisobini sizga qarzga berishni taklif qilayotgan bo'ladi. Prototip uchun bu oqilona qisqa yo'l bo'lishi mumkin. Biznes uchun esa bu bron saytingiz sizga tegishli bo'lmagan va o'zingiz bilan olib keta olmaydigan munosabat ustida ishlaydi degani.
Brif: texnik topshiriq uchun yetti band
Integrator bilan bo'ladigan nizolarning ko'pi hech kim yozmagan bitta jumladan boshlanadi. Quyidagilarni imzo chekadigan hujjatingizga oddiy so'zlar bilan kiriting va har biriga yozma javob so'rang.
- Yetkazib beruvchi hisobi va API kalitlari kimning nomida. Agentlikning. Kalitlar — kirish ma'lumotlari: ular sizning parollar omboringizda saqlanadi, integratorga esa egalik emas, ruxsat beriladi.
- Saytni kim joylashtiradi, domen kimda. Domen agentlik nomiga ro'yxatdan o'tgan. Xosting hisobi agentlikka tegishli yoki shartnomada u qanday topshirilishi aniq yozilgan.
- Ish hajmiga qaysi amallar kiradi. Ularni nomma-nom sanab yozing: qidiruv, narx, bron, chipta rasmiylashtirish, bekor qilish, pulni qaytarish, o'zgartirish. Ro'yxatda yo'q narsa saytning butun umri davomida yetkazib beruvchi bo'limiga yuboriladigan xat bo'lib qolaveradi. Eng ko'p tushib qoladiganlari — pulni qaytarish va o'zgartirish, chunki hech bir demo ularni ko'rsatmaydi.
- Yetkazib beruvchi API'ni o'zgartirganda qo'llab-quvvatlashni kim qiladi. Yetkazib beruvchilar eski versiyalarni yopadi, maydonlar nomini o'zgartiradi. Qo'llab-quvvatlash bandi bo'lmagan qat'iy narxli ish birinchi versiya o'zgargan kuni tugaydi.
- Topshirish nimani anglatadi. Agentlikka tegishli repozitoriydagi manba kodi, barcha kirish ma'lumotlari va boshqa dasturchiga ishni davom ettirish imkonini beradigan hujjat. "Sizga zip yuboramiz" — bu topshirish emas.
- Ishga tushirish qanday isbotlanadi. Yetkazib beruvchining test muhitida qidiruvdan chiptagacha, bekor qilish bilan birga, sinov broni — haqiqiy mijozning kartasidan pul yechilishidan oldin.
- Mijozlar ma'lumotlari bilan nima bo'ladi. Yo'lovchilar ismlari, pasport ma'lumotlari va to'lov havolalari: qayerda saqlanadi, kim o'qiy oladi va qanday o'chiriladi.
Bularning hech biri texnik bilim talab qilmaydi. Har birini ishdan oldin kelishib olish keyin savdolashishdan arzonroq tushadi.
Yetkazib beruvchi kontentini saytga chiqarishning uch yo'li
Yetkazib beruvchining API'siga integrator yollash — bitta yo'l. Biror tijorat taklifi siz uchun tanlov qilishidan oldin uni qolgan ikki yo'l bilan yonma-yon ko'rib chiqqan ma'qul.
| Yo'l | Yetkazib beruvchi bilan munosabat kimda | Ulanishni kim ishlatib turadi | Agentlik baribir nimani qurishi kerak | Ketishning bahosi |
|---|---|---|---|---|
| Integrator saytingizni yetkazib beruvchining API'siga ulaydi | Brifda yozilgan bo'lsa — agentlikda; aks holda ko'pincha integratorda | Qo'llab-quvvatlash shartnomasi bor integrator yoki hech kim | Boshqaruv paneli, ustama narx, mijozlar yozuvlari, hisobotlar, to'lovlar, xizmat ko'rsatish ekranlari | Kod va kalitlar sizniki bo'lsa — oz; bo'lmasa — qaytadan qurish |
| Integrator saytingizni platformaning API'siga ulaydi | Yetkazib beruvchi shartnomalari platformada; agentlikda platformadagi o'z hisobi | Yetkazib beruvchi tomonida platforma; sizning tomoningizda integrator | Saytingiz va platforma API'si qamramaydigan qism | O'z tomoningizni boshqa API uchun qayta yozish |
| Allaqachon ulangan white-label vitrina | Platforma, agentlik hisobi orqali | Platforma | Kontent, narx qarorlari, o'z mijozlaringiz | Domen va mijozlar ro'yxatini boshqa provayderga ko'chirish |
Bahslashishga arziydigan qator — birinchisi. U eng ko'p nazoratni beradi va eng ko'p yukni ham sizga yuklaydi: yetkazib beruvchining har bir o'zgarishi, har bir yangi xizmat va birinchi versiyada tushib qolgan har bir amal yangi tijorat taklifi bilan yangi loyihaga aylanadi.
Allaqachon yuritayotgan saytingizga qidiruvni qanday qo'shish mavjud saytga aviachipta qidiruvini qo'shish haqidagi maqolada, uning ortida kimning API'si turishi esa aviachipta bron qilish API provayderi ortida nima turadi maqolasida muhokama qilingan. Bu maqola o'sha ish atrofidagi shartnoma haqida.
Bu platforma qayerda turadi
Ushbu blog ortidagi platforma aviachipta va mehmonxona API'larini taqdim etadi. Ruxsat avtomatik beriladigan kalit bilan emas, suhbat bilan boshlanadi, chunki birinchi savollar yuqoridagilar (qaysi xizmatlar, qaysi bozor, pul qanday harakatlanadi), qaysi endpoint'ni chaqirish emas. Xizmatlar har bir hisob uchun alohida yoqiladi va har bir hisobning o'z bronlari, mijozlari, ustama narxlari va hisobotlari bo'lgan o'z boshqaruv paneli bor — shuning uchun ikkinchi qatordagi "baribir nimani qurishi kerak" ustuni ko'ringanidan qisqaroq.
Agar sizning tomoningizni integratsiya kompaniyasi quradigan bo'lsa, bu suhbatni tijorat taklifini qabul qilishdan oldin o'tkazing, shunda ish hajmi u haqiqatan ulanadigan API'ni tasvirlaydi. Boshlanish nuqtasi — turizm API'lari sahifasi.
Zaif brif sizga qanchaga tushadi
Sayt ishga tushadi. Qidiruv ishlaydi, narxlar to'g'ri ko'rinadi, birinchi bron payshanba kuni kechqurun keladi. Uni sizning nomingizdan rasmiylashtirib bo'lmaydi, chunki yetkazib beruvchi hisobi integratorga tegishli va uning kelishuvi bo'yicha chipta chiqaradi. Mijozning kartasidan pul allaqachon yechilgan. Endi qo'lingizda o'z saytingizdan na rasmiylashtira, na qaytara oladigan bron bor.
Yoki u bir yil ishlaydi. Keyin yetkazib beruvchi API'ning yangi versiyasiga o'tadi, bronlar to'xtaydi, qat'iy narxli shartnomasi topshirish paytida tugagan integrator esa yangi loyiha uchun taklif yuboradi. Siz to'laysiz, chunki kodni tushunadiganlar faqat taklif yuborayotganlardir.
Yoki integrator shunchaki boshqa joyda band. Mijoz chiptadagi ismini tuzattirmoqchi, o'zgartirish amali hech qachon ish hajmida bo'lmagan va ikki xodimingiz tushdan keyingi vaqtini yetkazib beruvchi bo'limiga xat yozish bilan o'tkazadi. Aynan sayt olib tashlashi kerak bo'lgan ish.
Bu holatlarning har biri brifda yetishmagan bitta jumla. Kod esa har safar joyida edi.