Məzmuna keçin
Bloq

Dubayda API inteqrasiya şirkəti tutmazdan əvvəl

Tekravel Redaksiyası
Süni intellektin köməyi ilə yazılıb

Masada üç qiymət təklifi var. Hər inteqrasiya şirkətinin turizm saytlarından ibarət portfoliosu var, hər biri "saytınıza aviabilet API qoşmağı" vəd edir, ən ucuzu isə gələn həftə işə başlaya bilər. Siz Deyrada altı nəfərlik agentlik idarə edirsiniz, korporativ müştəri portfeliniz sabitdir və təchizatçının ekstranetindən tarifləri WhatsApp mesajlarına köçürməkdən bezmisiniz. Dubayda ən bacarıqlı görünən API inteqrasiya şirkətini seçmək bütün qərar kimi görünür.

Bu, qərarın təxminən üçdə biridir. Saytın satıb-satmayacağını müəyyən edən məsələlər üç təklifin heç birində yoxdur, çünki onlar kod deyil. Sual budur: təchizatçı müqaviləni kimlə imzalayıb, biletlər kimin adına buraxılır, rezervasiya ilə bilet buraxılışı arasında pul harada qalır və müştəri imtina edəndə geri ödənişlə kim məşğul olur. İnteqrator bunların hamısını bir-birinə bağlaya bilər. Sizin əvəzinizə onlardan biri ola bilməz.

Bu yazı texniki tapşırığı imzalayacaq sahibkar üçündür, onu oxuyacaq proqramçı üçün yox.

Dubayda API inteqrasiya şirkəti nə verə bilər, nə verə bilməz

İnteqrasiya şirkəti təchizatçının API-si ilə sizin sayt arasındakı kodu yazır: axtarış forması, yerlərin mövcudluğunu soruşan sorğu, ödənişdən əvvəl qiymətin yoxlanması, rezervasiya sorğusu, nəticəni göstərən ekranlar və əgər iş həcmində yazılıbsa, ləğv və geri ödəniş sorğuları. Yaxşı şirkətlər darıxdırıcı, amma vacib hissələri də öz üzərinə götürür: təchizatçı vaxtında cavab vermədikdə təkrar cəhdlər, uğursuz rezervasiyanı izləməyə imkan verən loglar, istehsal mühiti kimi davranan test mühiti.

Sizə verə bilmədiyi isə o kodun o biri tərəfindəki hər şeydir. Bir sətir yazılmazdan əvvəl agentliyə lazımdır:

  • agentliyin öz adına açılmış təchizatçı hesabı, API girişi də məhz həmin hesaba verilmiş olmalıdır;
  • bilet buraxmaq səlahiyyəti — ya öz akkreditasiyanız, ya da sizin adınızdan bilet buraxan consolidator;
  • həmin təchizatçı ilə maliyyə razılaşması: depozit, kredit xətti və ya kart ödənişlərinin birbaşa ötürülməsi;
  • biletdən sonrakı işi (void, geri ödəniş, yenidən buraxılış, cədvəl dəyişiklikləri) görən kimsə — API vasitəsilə, mümkün olmasa, əl ilə.

"Təchizatçı tərəfini biz həll edərik" deyən inteqrator adətən öz hesabını sizə borc verməyi təklif edir. Prototip üçün bu, ağlabatan qısa yol ola bilər. Biznes üçün isə bu o deməkdir ki, rezervasiya saytınız sizə məxsus olmayan və özünüzlə apara bilməyəcəyiniz münasibət üzərində işləyir.

Brif: texniki tapşırıq üçün yeddi bənd

İnteqratorla mübahisələrin çoxu heç kimin yazmadığı bir cümlədən başlayır. Bunları imzaladığınız sənədə sadə sözlərlə daxil edin və hər birinə yazılı cavab istəyin.

  1. Təchizatçı hesabı və API açarları kimin adınadır. Agentliyin. Açarlar giriş məlumatlarıdır: onlar sizin parol saxlancınızda durur, inteqratora isə mülkiyyət yox, giriş verilir.
  2. Saytı kim yerləşdirir, domen kimdədir. Domen agentliyin adına qeydiyyatdadır. Hostinq hesabı agentliyə məxsusdur, ya da müqavilədə onun necə təhvil veriləcəyi dəqiq yazılıb.
  3. Hansı əməliyyatlar iş həcminə daxildir. Onları adbaad sadalayın: axtarış, qiymət, rezervasiya, bilet buraxılışı, ləğv, geri ödəniş, dəyişiklik. Siyahıda olmayan hər şey saytın bütün ömrü boyu təchizatçının masasına göndərilən e-poçt olaraq qalacaq. Ən çox unudulanlar geri ödəniş və dəyişiklikdir, çünki heç bir demo onları göstərmir.
  4. Təchizatçı API-ni dəyişəndə dəstəyi kim verir. Təchizatçılar köhnə versiyaları bağlayır, sahələrin adını dəyişir. Dəstək bəndi olmayan sabit qiymətli iş ilk versiya dəyişdiyi gün bitir.
  5. Təhvil nə deməkdir. Agentliyə məxsus repozitoriyada mənbə kodu, bütün giriş məlumatları və başqa proqramçının işi davam etdirməsinə imkan verən sənəd. "Sizə zip göndərərik" təhvil deyil.
  6. İşə düşmə necə sübut olunur. Təchizatçının test mühitində axtarışdan biletə qədər, ləğv də daxil olmaqla, test rezervasiyası — real müştərinin kartından pul çəkilməzdən əvvəl.
  7. Müştəri məlumatları ilə nə olur. Sərnişin adları, pasport məlumatları və ödəniş istinadları: harada saxlanılır, kim oxuya bilər və necə silinir.

Bunların heç biri texniki bilik tələb etmir. Hər biri işdən əvvəl razılaşdırılanda sonradan danışıqla həll etməkdən ucuz başa gəlir.

Təchizatçı kontentini sayta çıxarmağın üç yolu

Təchizatçının API-si üçün inteqrator tutmaq bir yoldur. Hansısa qiymət təklifi sizin əvəzinizə seçim etməzdən əvvəl onu digər iki yolla yanaşı görmək faydalıdır.

YolTəchizatçı ilə münasibət kimdədirBağlantını işlək saxlayan kimdirAgentlik yenə nə qurmalıdırÇıxıb getməyin dəyəri
İnteqrator saytınızı təchizatçının API-sinə qoşurBrifdə yazılıbsa agentlikdə; yoxsa çox vaxt inteqratordaDəstək müqaviləsi olan inteqrator, ya da heç kimİdarəetmə paneli, əlavə qiymət, müştəri qeydləri, hesabatlar, ödənişlər, xidmət ekranlarıKod və açarlar sizindirsə az; deyilsə, yenidən qurmaq
İnteqrator saytınızı platformanın API-sinə qoşurTəchizatçı müqavilələri platformada; agentlikdə isə platformadakı hesabıTəchizatçı tərəfdə platforma; sizin tərəfdə inteqratorSaytınız və platformanın API-sinin əhatə etmədiyi hissəÖz tərəfinizi başqa API üçün yenidən yazmaq
Artıq qoşulmuş white-label vitrinPlatforma, agentliyin hesabı vasitəsiləPlatformaKontent, qiymət qərarları, öz müştərilərinizDomeni və müştəri siyahısını başqa provayderə köçürmək

Mübahisəyə dəyən sətir birincidir. O, ən çox nəzarəti verir və ən çox yükü də sizin üzərinizə qoyur: təchizatçının hər dəyişikliyi, hər yeni xidmət və ilk versiyada unudulan hər əməliyyat yeni qiymət təklifi ilə yeni layihəyə çevrilir.

Artıq işlətdiyiniz sayta axtarışı necə əlavə etmək mövcud sayta aviabilet axtarışı əlavə etmək yazısında, onun arxasında kimin API-sinin durması isə aviabilet rezervasiyası API provayderinin arxasında nə dayanır yazısında müzakirə olunur. Bu yazı həmin işin ətrafındakı müqavilə haqqındadır.

Bu platforma harada dayanır

Bu bloqun arxasındakı platforma aviabilet və otel API-ləri təqdim edir. Giriş avtomatik verilən açarla yox, söhbətlə başlayır, çünki ilk suallar yuxarıdakılardır (hansı xidmətlər, hansı bazar, pul necə hərəkət edir), hansı endpoint-in çağırılması yox. Xidmətlər hər hesab üçün ayrıca aktivləşdirilir və hər hesabın öz rezervasiyaları, müştəriləri, əlavə qiymətləri və hesabatları olan öz idarəetmə paneli var — buna görə ikinci sətirdə "yenə nə qurmalıdır" sütunu göründüyündən qısadır.

Sizin tərəfi inteqrasiya şirkəti quracaqsa, bu söhbəti qiymət təklifini qəbul etməzdən əvvəl aparın ki, iş həcmi həqiqətən qoşulacağı API-ni təsvir etsin. Başlanğıc nöqtəsi turizm API-ləri səhifəsidir.

Zəif brif sizə neçəyə başa gəlir

Sayt işə düşür. Axtarış işləyir, qiymətlər düzgün görünür və ilk rezervasiya cümə axşamı axşam gəlir. Onu sizin adınıza biletləmək mümkün deyil, çünki təchizatçı hesabı inteqratora məxsusdur və onun razılaşması ilə bilet buraxır. Müştərinin kartından pul artıq çəkilib. İndi əlinizdə öz saytınızdan nə biletləyə, nə də geri qaytara bildiyiniz rezervasiya var.

Ya da bir il işləyir. Sonra təchizatçı yeni API versiyasına keçir, rezervasiyalar dayanır və sabit qiymətli müqaviləsi təhvil zamanı bitmiş inteqrator yeni layihə üçün qiymət təklifi göndərir. Siz ödəyirsiniz, çünki kodu başa düşənlər yalnız təklifi göndərənlərdir.

Ya da inteqrator sadəcə başqa yerdə məşğuldur. Müştəri biletdəki adı düzəltdirmək istəyir, dəyişiklik əməliyyatı heç vaxt iş həcmində olmayıb və iki əməkdaşınız bütün günortanı təchizatçının masasına e-poçt yazmaqla keçirir. Məhz saytın aradan götürməli olduğu iş.

Bu halların hər biri brifdə çatışmayan bir cümlədir. Kod isə hər dəfə qaydasında idi.

Tekravel Redaksiyası

Səyahət texnologiyaları masası

Tekravel-in səyahət texnologiyaları masası sənaye üçün yazır: agentlik sahibləri, konsolidatorlar və onları inteqrasiya edən developerlər. Hər məqalə dərc olunmazdan əvvəl təsvir etdiyi platformada yoxlanılır.