API ve Sistem Entegrasyonu: Programlarınızı Birbirine Bağlamak

// Sistem entegrasyonu kime uygun?

Sistem entegrasyonu, aynı bilgiyi birden fazla programa elle giren ya da programlar arasında veri taşımak için her gün saatler harcayan işletmeler içindir. Elle aktarım yalnızca zaman değil hata da üretir: yanlış stok, eksik fatura, gecikmiş kargo. Programlar zaten API sunuyorsa sistem entegrasyonu bir kez yazılır ve yıllarca kendi kendine çalışır. Aşağıdaki durumlardan birindeyseniz doğru sayfadasınız.

• Siparişler e-ticaretten muhasebeye her gün elle giriliyor
• Web formundan gelen başvurular CRM'e kopyalanıyor, bazıları kayboluyor
• Stok üç yerde tutuluyor: mağaza, depo programı ve pazaryeri
• İki program "entegre" satıldı ama aslında Excel dışa-içe aktarımıyla çalışıyor

İki programlı küçük işletmeden 8 sistemli üreticiye aynı yöntemi uyguluyoruz; değişen bağlantı sayısı ve veri hacmidir.

// Kapsama dahil olanlar ve olmayanlar

Proje bağlantı bazlı yürür; her bağlantı ayrı analiz edilir ve fiyatlanır. Aşağıdaki tablo standart projede olanı ve dışarıda kalanları satır satır gösterir. Bağlanacak programların API sunması gerekir; sunmayan programlar için dosya tabanlı alternatif değerlendirilir ve bu sınır teklifte açıkça yazılıdır, sonradan değişmez.

Bağlantı yeni bir uygulama gerektiriyorsa web uygulama geliştirme ayrı sayfada anlatılır; WordPress ve WooCommerce tarafındaki bağlantılar WordPress özel geliştirme kapsamındadır.

// Nasıl işliyor, ne kadar sürüyor?

Tek yönlü basit bir bağlantı 1 ile 2 hafta, çift yönlü ve çok alanlı bir bağlantı 3 ile 5 hafta sürer; süre analiz raporunda bağlantı bazında yazılır. Bağlantı önce test ortamında örnek veriyle denenir, sonra gerçek veriyle birkaç gün paralel çalıştırılır; doğrulanmadan canlıya alınmaz. Teslimden sonra 60 gün hata düzeltme güvencesi vardır.

// Fiyat neye göre belirleniyor?

Fiyatı üç değişken belirler: bağlantı sayısı, yön (tek ya da çift yönlü) ve veri alanı sayısı. Web formundan CRM'e tek yönlü 5 alanlık bir bağlantıyla e-ticaret, muhasebe ve kargo arasında çift yönlü 40 alanlık bir bağlantı aynı iş yükü taşımadığından sabit liste yerine analiz raporuna dayalı teklif veriyoruz. Analiz ücretsizdir ve teklif eşleme tablosu onaylandıktan sonra sabitlenir.

Programın API'si beklenmedik biçimde eksik çıkarsa alternatif yol ve maliyeti yazılı sunulur; onaysız ilerlenmez. Ödeme teslim aşamalarına bölünür. Kod ve erişimler sizindir.

// Aldığımız sonuçlar

Aşağıdaki üç vaka farklı bağlantı türlerini temsil eder. Müşteri adlarını izinleri olmadan paylaşmadığımız için sektör ve ölçek bilgisiyle veriyoruz; rakamlar izleme panelinden ve müşteri ölçümlerinden alınmıştır. Üçünde de bağlantı Zep Bilişim tarafından paralel çalışmayla doğrulanıp canlıya alındı ve izleme paneliyle teslim edildi.

• Toptancı, stok programı ile WooCommerce — İki yönlü stok ve sipariş bağlantısı; günde 2 saatlik elle giriş kalktı, stok uyuşmazlığı kaynaklı iptal %7'den sıfıra indi
• Sigorta acentesi, web formu ile CRM — Başvurular anında CRM'e düşüyor, temsilciye atanıyor; kaybolan başvuru sorunu bitti, ilk dönüş süresi 1 günden 2 saate indi
• Üretici, muhasebe ile e-ticaret ve kargo — Sipariş otomatik faturalanıyor ve kargo etiketi üretiliyor; aylık 1.200 siparişin işlenmesi 3 kişiden 1 kişiye düştü

İki programın "entegre" olması Excel'in bir yerden indirilip diğerine yüklenmesi değildir. Gerçek entegrasyon siz uyurken çalışır ve hata verdiğinde size haber verir.

// İşi yürüten ekip

Projeyi Zep Bilişim kurucusu Caner Zep Çelik yürütüyor. Kurucu ve teknik danışman olarak 2020'den bu yana API entegrasyonları, yazılım mimarisi ve web geliştirme üzerine çalışıyor; bugüne kadar 100'ün üzerinde projede yer aldı. Analizi, veri eşlemesini ve hata yönetimi tasarımını kendisi yapıyor, işi taşerona devretmiyor.

Teknik belge aynı kişi tarafından yazılır: bağlantının mimarisi, eşleme tablosu, hata durumlarında ne yapılacağı, erişim anahtarlarının nerede tutulduğu. Belge ileride başka bir ekibin bağlantıyı sürdürebilmesini sağlar.

// Hangi durumlarda gerekmez?

İki program arasında zaten resmî ve çalışan bir entegrasyon varsa yeniden yazmak gereksizdir; analizde bunu açıkça söylüyoruz ve mevcut bağlantının doğru yapılandırılmasını öneriyoruz. Aktarılan veri ayda birkaç kayıtsa ve elle giriş 10 dakika alıyorsa entegrasyon maliyetini karşılamaz; bunu da görüşmede belirtiyoruz.

Programlardan biri API sunmuyor ve dosya aktarımı da desteklemiyorsa bağlantı kurulamaz; o durumda program değişikliği değerlendirilir ve sırayı buna göre yazıyoruz.

OWASP'ın API güvenliği ilk 10 listesi yazdığımız her bağlantıda kontrol ettiğimiz güvenlik risklerini bağımsız kaynaktan açıklar; test adımımız bu listeye göre kurulur.

// Sıkça Sorulan Sorular