Bir çox şirkətdə gündəlik iş belə görünür: saytdan gələn sifariş e-poçtla düşür, menecer onu CRM-ə əl ilə köçürür, ödənişin gəlib-gəlmədiyini bank kabinetindən yoxlayır, mühasib isə ay sonunda bütün bunları yenidən mühasibat proqramına daxil edir. Hər addım vaxt aparır və hər əl ilə köçürmə səhv ehtimalı deməkdir. API inteqrasiyası bu sistemləri bir-biri ilə birbaşa danışdırır. Bu yazıda inteqrasiyanın necə planlaşdırıldığını, hansı texniki qərarların vacib olduğunu və nəyə diqqət etmək lazım olduğunu izah edirik.
API və inteqrasiya: əsas anlayışlar
API (proqram interfeysi) bir sistemin digər sistemlərə məlumat verməsi və onlardan əmr qəbul etməsi üçün müəyyən edilmiş qaydalar toplusudur. Məsələn, CRM-in API-si vasitəsilə yeni müştəri kartı yaratmaq, ödəniş sisteminin API-si vasitəsilə ödəniş səhifəsi açmaq və ya mühasibat proqramına qaimə göndərmək olar.
İnteqrasiyada iki əsas mexanizm işlədilir:
- Sorğu (request): sistem lazım olanda digərinə müraciət edir. Məsələn, sayt sifariş yaradılanda CRM-ə məlumat göndərir.
- Webhook: hadisə baş verəndə digər sistem özü xəbər verir. Məsələn, ödəniş təsdiqlənəndə ödəniş sistemi sayta bildiriş göndərir və sifarişin statusu avtomatik dəyişir.
Webhook-lar xüsusilə vacibdir, çünki ödəniş kimi hadisələrin nəticəsini istifadəçinin brauzerinə etibar etmədən, birbaşa serverlər arasında təsdiqləməyə imkan verir.
Mübadilə adətən JSON formatında aparılır və hər xidmət öz API sənədində hansı sorğuların mümkün olduğunu, hansı sahələrin məcburi olduğunu və hansı limitlərin tətbiq edildiyini göstərir. İnteqrasiyaya başlamazdan əvvəl bu sənədləri oxumaq vacibdir: bəzən lazım olan əməliyyat API-də ümumiyyətlə yoxdur və ya yalnız müəyyən tarif planında əlçatandır. Bunu layihənin ortasında öyrənmək həm müddətə, həm də büdcəyə təsir edir.
Başlamazdan əvvəl: prosesi xəritələyin
İnteqrasiya texniki iş kimi görünsə də, onun uğuru biznes prosesinin aydın təsvirindən asılıdır. Proqramlaşdırmaya başlamazdan əvvəl bu suallara cavab verin:
- Hansı hadisələr məlumat axınını başladır? Yeni müraciət, sifariş, ödəniş, qaytarma, müştəri məlumatının dəyişməsi.
- Hər məlumatın "əsas mənbəyi" hansı sistemdir? Məsələn, müştəri məlumatı CRM-də, məhsul qiyməti mühasibat və ya anbar sistemində, ödəniş statusu ödəniş sistemində.
- Məlumat hansı istiqamətdə gedir? Bir tərəfli ötürmə ilə iki tərəfli sinxronizasiya arasında mürəkkəblik fərqi böyükdür.
- Nə qədər tez ötürülməlidir? Ödəniş təsdiqi dərhal lazımdır, mühasibat hesabatı üçün isə gündəlik ötürmə kifayət edə bilər.
- Uyğunsuzluq olanda kim qərar verir? İki sistemdə eyni müştərinin fərqli telefonu varsa, hansı düzgün sayılır?
İnteqrasiyanın ən çox yayılmış problemi texniki deyil: məlumatın hansı sistemdə "doğru" sayıldığı əvvəlcədən müəyyənləşdirilmədikdə sistemlər bir-birinin məlumatını üzərinə yazmağa başlayır.
Tipik inteqrasiya ssenariləri
Sayt və CRM
Formadan gələn müraciət avtomatik olaraq CRM-də yeni müştəri və ya sövdələşmə kimi yaradılır, mənbə (hansı səhifə, hansı kampaniya) qeyd olunur, məsul menecerə tapşırıq düşür. Təkrarlanan müştəri tanınır və yeni kart yaradılmır, mövcud karta əlavə olunur.
Sayt və ödəniş sistemi
Sifariş yaradılır, istifadəçi ödəniş səhifəsinə yönləndirilir, ödəniş sistemi nəticəni webhook ilə serverə bildirir və sifariş "ödənilib" statusuna keçir. Burada vacib olanlar: məbləğin serverdə yoxlanılması, eyni bildirişin təkrar gəlməsi halında ikiqat emal olunmaması, ödəniş baş tutmayanda sifarişin düzgün statusda qalması və qaytarmaların da sistemdə əks olunması.
Satış və mühasibat
Ödənilmiş sifarişlər əsasında mühasibat proqramında müvafiq sənədlər yaradılır, məhsul və xidmətlər mühasibat kataloquna uyğunlaşdırılır. Bu ssenaridə əsas çətinlik adətən kodlaşdırmadır: saytdakı məhsul ilə mühasibatdakı nomenklatura bir-birinə dəqiq bağlanmalıdır.
Anbar və qalıqlar
Onlayn mağazada məhsul qalığı anbar sistemindən götürülür ki, olmayan məhsul satılmasın. Burada sinxronizasiyanın tezliyi və eyni anda bir neçə kanal üzrə satış olanda qalığın düzgün hesablanması vacibdir.
Etibarlılıq və təhlükəsizlik
Etibarlı inteqrasiyanın texniki şərtləri
- Xətaların idarəsi. Xarici sistem müvəqqəti cavab vermirsə, sorğu itməməli, növbəyə (queue) düşüb sonra təkrar göndərilməlidir.
- İdempotentlik. Eyni sorğu və ya webhook bir neçə dəfə gəlsə də, nəticə bir dəfə tətbiq olunmalıdır: bir ödəniş iki sifariş və ya iki qaimə yaratmamalıdır.
- Jurnal və monitorinq. Hər mübadilə qeyd olunmalı, uğursuz əməliyyatlar barədə məsul şəxs xəbərdar edilməlidir. Problemi müştəri şikayəti ilə öyrənmək gec olur.
- Versiya dəyişiklikləri. Xarici xidmətlər öz API-lərini yeniləyir. İnteqrasiya sənədləşdirilməli və dəyişikliklərə nəzarət edilməlidir.
- Test mühiti. Ödəniş və mühasibat inteqrasiyaları əvvəlcə təminatçının test (sandbox) mühitində yoxlanılmalıdır.
Təhlükəsizlik
İnteqrasiya sistemlər arasında yeni giriş nöqtələri açır, ona görə təhlükəsizlik ayrıca planlaşdırılmalıdır:
- API açarları və girişlər kodda deyil, qorunan konfiqurasiyada saxlanılmalı, yalnız lazım olan icazələrlə verilməlidir.
- Gələn webhook-ların imzası yoxlanılmalıdır ki, saxta bildirişlə sifariş "ödənilmiş" edilməsin.
- Bütün mübadilə HTTPS üzərindən aparılmalıdır.
- Kart məlumatları kimi həssas məlumatlar sizin serverinizdə saxlanılmamalıdır; bu işi ödəniş təminatçısı görür.
- Şəxsi məlumatların hansı sistemlərə ötürüldüyü bilinməli və yalnız zəruri olanlar ötürülməlidir.
Hazır modul, yoxsa xüsusi inteqrasiya
Bir çox platforma və xidmət üçün hazır inteqrasiya modulları, plaginlər və ya "bağlayıcı" xidmətlər mövcuddur. Məsələn, WooCommerce üçün ödəniş sistemlərinin və bəzi CRM-lərin hazır plaginləri olur. Standart ssenari üçün bu, sürətli və sərfəli yoldur.
Amma hazır modulu seçməzdən əvvəl bir neçə məqamı yoxlayın:
- Modul sizin prosesinizi tam əhatə edirmi, yoxsa yalnız əsas hissəni? Məsələn, qaytarmalar və qismən ödənişlər nəzərə alınıbmı?
- Modulu kim saxlayır və o, nə qədər müntəzəm yenilənir?
- Xəta baş verəndə bu barədə necə xəbər tutacaqsınız?
- Məlumatlar hansı üçüncü tərəf serverlərindən keçir?
Prosesiniz qeyri-standartdırsa, bir neçə sistem arasında mürəkkəb məntiq varsa və ya etibarlılıq kritikdirsə, xüsusi yazılmış inteqrasiya daha idarə olunan nəticə verir: məntiq sizin tələblərinizə görə qurulur, jurnal və monitorinq isə ehtiyacınıza uyğun olur.
Mərhələli tətbiq və texniki xidmət
İnteqrasiyanın sahibi kimdir
İnteqrasiya bir dəfə qurulub unudulan iş deyil. Xarici xidmətlər API-lərini dəyişir, sertifikatlar və açarlar yenilənir, biznes prosesi özü də inkişaf edir. Ona görə əvvəlcədən müəyyənləşdirin: inteqrasiyanın işləməsinə kim cavabdehdir, xəta bildirişləri kimə gedir, sənədləşmə harada saxlanılır və dəyişiklik lazım olanda kimə müraciət olunur. Bu suallara cavab olmayanda kiçik bir dəyişiklik bütün məlumat axınını həftələrlə dayandıra bilər.
Kiçikdən başlayın
Bütün sistemləri bir anda birləşdirməyə çalışmaq riskli və bahalıdır. Daha praktik yol ən çox vaxt aparan və ən çox səhv yaradan prosesdən başlamaqdır. Adətən bu, saytdan CRM-ə müraciətlərin ötürülməsi və ya ödəniş statusunun avtomatik yenilənməsidir. Birinci inteqrasiya sabit işlədikdən sonra növbəti əlaqə əlavə olunur. Bu yanaşma həm büdcəni bölməyə, həm də hər mərhələnin real faydasını görməyə imkan verir.
Nəticə
API inteqrasiyası əl ilə köçürməni aradan qaldırır, məlumatların dəqiqliyini artırır və komandanın vaxtını rutin işdən azad edir. Amma onun uğuru prosesin aydın xəritəsindən, məlumatın əsas mənbəyinin müəyyənləşdirilməsindən, xətaların düzgün idarəsindən və təhlükəsizlikdən asılıdır. Sisteminizi birləşdirmək və ya mövcud inteqrasiyanı yoxlamaq istəyirsinizsə, TRUE ilə layihənizi müzakirə edin.
