Həll
proses + nəzarətŞirkətlərin çoxunda problem proqramın olmaması deyil — proqramların bir-biri ilə danışmamasıdır. Sifariş saytda, müştəri CRM-də, qalıq anbarda, sənəd mühasibatda yaşayır; arada isə işçi oturub eyni məlumatı üçüncü dəfə əl ilə köçürür. API inteqrasiya bu əl əməyini aradan qaldırır.
Nəyi nəyə bağlayırıq
- Sayt və ya online mağaza ilə anbar, uçot və CRM sistemləri.
- Bank və ödəniş prosessinqi: ödəniş statusu, geri qaytarma, çıxarış idxalı.
- Çatdırılma və kuryer xidmətləri: yük yaratma, status və izləmə kodu.
- SMS, email, WhatsApp və Telegram bildiriş kanalları.
- Xarici kataloq və qiymət mənbələri, təchizatçı sistemləri.
Hazır API olmayanda
Bəzi yerli proqramların açıq interfeysi yoxdur. Belə hallarda variantları qiymətləndiririk: verilənlər bazası səviyyəsində oxuma, cədvəl faylları ilə mübadilə, aralıq xidmət yazılması. Hansı yolun seçildiyini və onun məhdudiyyətlərini əvvəlcədən açıq deyirik.
Etibarlılıq
İnteqrasiyanın əsl sınağı işlədiyi gün deyil, xarici xidmətin cavab vermədiyi gündür. Ona görə hər əlaqə üçün təkrar cəhd məntiqi, növbə və xəta jurnalı qururuq. Uğursuz əməliyyat itmir — növbədə qalır və bərpadan sonra icra olunur.
- Bütün sorğu və cavabların jurnala yazılması.
- Təkrarlanan xətalarda məsul şəxsə bildiriş.
- Eyni əməliyyatın iki dəfə işlənməsinin qarşısının alınması.
- Açar və tokenlərin təhlükəsiz saxlanması, dövri yenilənməsi.
Öz API-nizin hazırlanması
Tərəfdaşlarınız və ya mobil tətbiqiniz sizin sistemə qoşulmalıdırsa, sənədləşdirilmiş API hazırlayırıq: giriş nəzarəti, sorğu limiti, versiyalaşdırma və test mühiti ilə birlikdə.
Sınaq və təhvil
İnteqrasiya əvvəlcə test mühitində qurulur, real məlumatla yoxlanılır, yalnız bundan sonra işlək sistemə keçirilir. Təhvildən sonra bir müddət nəzarətdə saxlayırıq — xarici xidmətlərin qaydaları vaxtaşırı dəyişir və uyğunlaşma tələb olunur.
İş ssenarisinin qəbul meyarları
Naməlum kod, boş məcburi sahə, təkrar sorğu və əlaqə kəsilməsi sınaqları vacibdir. Təkrar qəbul eyni əməliyyatı ikinci dəfə yaratmamalıdır.
Layihə üçün hazırlıq məlumatları
Hər iki sistemin sənədi, sınaq mühiti və məlumat nümunələri tələb olunur. Canlı giriş açarları məqalədə, açıq sənəddə və brauzer kodunda paylaşılmamalıdır.
Nümunə ssenari
Nümunə qəbul: qarşı sistem sifarişi qəbul edir, amma cavab yolda itir. Göndərən tərəf yenidən cəhd etdikdə eyni sifarişin identifikatoru tanınmalıdır. Həm qeyd, həm əməliyyat nəticəsi təkrarlanmadan yoxlanmalıdır.
