API ve Sistem Entegrasyonları

API ve sistem entegrasyonları nedir?

Entegrasyon, birbirinden bağımsız çalışan yazılımların belirli verileri otomatik olarak paylaşmasıdır. Bir kurumda genellikle birden fazla sistem bulunur: muhasebe programı, ERP, CRM, e-ticaret sitesi, kargo firmasının paneli, banka arayüzü. Her biri kendi başına iyi çalışıyor olabilir; sorun çoğu zaman bunların arasındadır.

Arada kalan boşluğu insan doldurur. Aynı sipariş bir sisteme girilip diğerine elle kopyalanır, stok listesi haftada bir dışa aktarılıp yeniden yüklenir, ay sonunda iki raporun neden tutmadığı araştırılır. Bu iş görünmez bir maliyettir: kimsenin görev tanımında yazmaz ama herkesin gününden zaman alır ve hataların büyük bölümü tam da burada oluşur.

API (uygulama programlama arayüzü), bir sistemin dışarıya açtığı kapıdır: hangi verinin okunabileceğini, hangisinin yazılabileceğini ve bunun nasıl yapılacağını tanımlar. Entegrasyon işi, bu kapıları doğru şekilde birbirine bağlamak, kapısı olmayan sistemler için uygun bir yol bulmak ve akışın zamanla bozulmayacağı bir yapı kurmaktır.

Bu işin zorluğu genellikle teknik değil, sınırlarla ilgilidir: karşı sistemin neye izin verdiği, tedarikçisinin ne taahhüt ettiği ve verinin gerçekte hangi biçimde tutulduğu. Bu yüzden bir entegrasyonu vaat etmeden önce karşı tarafın belgelerini ve gerçek verisinden bir örneği inceliyoruz; kâğıt üzerinde mümkün görünen bağlantı uygulamada sınırlı çıkabilir ve bunu baştan bilmek gerekir.

Neler yapıyoruz?

Entegrasyon projeleri genellikle tek bir bağlantıyla başlar ve zamanla büyür. Bu yüzden ilk kurulumda bile akışları tek tek yazılmış betikler olarak değil, üzerine eklenebilir bir yapı olarak kuruyoruz. Böylece ikinci ve üçüncü bağlantı, birincisinin kurduğu kayıt, hata yönetimi ve izleme altyapısını yeniden kullanır.

• Sistemler arası veri akışı — ERP, CRM, muhasebe, e-ticaret ve kurum içi uygulamalar arasında sipariş, stok, cari hesap, fatura ve müşteri verisinin akışını kurarız. Hangi verinin hangi yöne aktığı tek bir şemada görünür hâle gelir.
• API geliştirme — Kendi sisteminizin dışarıya açılması gerektiğinde API’yi biz yazarız: kimlik doğrulama, yetkilendirme, sürümleme, istek sınırlama ve belgelendirme dâhil. Belgesiz bir API, olmayan API ile aynı sonucu verir.
• Hazır servis bağlantıları — Ödeme, kargo, e-fatura, SMS ve harita gibi dış servislerin bağlantıları kurulur. Bu servislerin hata durumları ve yeniden deneme davranışları da işin parçasıdır.
• Otomatik senkronizasyon — Zamanlanmış görevlerle veri düzenli aralıklarla eşitlenir. Yalnızca değişen kayıtlar aktarılır; her seferinde tüm veriyi taşımak hem yavaştır hem karşı sistemi yorar.
• Webhook kurulumu — Olay gerçekleştiği anda bildirim alınır. Bildirimin gerçekten karşı sistemden geldiği doğrulanır ve aynı bildirimin iki kez işlenmesi engellenir.
• Kayıt ve izleme — Her aktarımın ne zaman çalıştığı, kaç kayıt taşıdığı ve hangilerinin başarısız olduğu kaydedilir. Kalıcı hatada bildirim gider; akış sessizce durmaz.
• Veri dönüşümü — İki sistem aynı bilgiyi farklı biçimde tutar: tarih biçimi, para birimi, ürün kodu, vergi oranı. Dönüşüm kuralları tek bir yerde tanımlanır ve belgelenir.
• Güvenlik — Kimlik doğrulama anahtarları uygulama kodunun içinde tutulmaz, erişim yalnızca gereken veriyle sınırlanır ve bağlantılar şifreli kanaldan kurulur. Entegrasyon iki sistem arasında açılmış yeni bir kapıdır; kapının kime açık olduğu tanımlı olmalıdır.
• Belgeleme ve devir — Akış şeması, alan eşlemeleri ve dönüşüm kuralları yazılı bırakılır. Entegrasyonların bakımı, yazan kişinin hafızasına bırakıldığında en zor iş hâline gelir.

Nasıl çalışıyoruz?

1. Sistem envanteri — Hangi sistemler var, her biri hangi veriyi tutuyor, aralarında bugün ne elle taşınıyor. Bu harita çıkmadan hangi entegrasyonun gerçekten değer üreteceği bilinemez.
2. Sahiplik kararı — Her veri alanı için hangi sistemin sahip olduğu belirlenir. Çakışma durumunda hangisinin kazanacağı yazılı hâle getirilir; bu karar sonradan verilirse veri kaybıyla verilir.
3. Bağlantı yönteminin seçimi — Karşı sistemin API’si, veritabanı erişimi veya dosya aktarımı seçeneklerinden hangisinin uygun olduğu belirlenir. Karşı tarafın tedarikçisiyle konuşulması gerekiyorsa bu görüşmeyi biz yürütürüz.
4. Deneme ortamında kurulum — Entegrasyon önce canlı olmayan bir ortamda kurulur ve gerçek verinin kopyasıyla denenir. Yanlış yönde çalışan bir aktarımın canlıda öğrenilmesi pahalıdır.
5. Kademeli devreye alma — Akış önce tek yönlü ve sınırlı bir veri kümesiyle açılır; doğruluk kontrol edildikten sonra kapsam genişletilir.
6. İzleme ve bakım — Yayın sonrası kayıtlar düzenli gözden geçirilir. Karşı sistemin sürüm değişiklikleri, sona eren anahtarlar ve kullanımdan kaldırılan uçlar takip edilir.

Ne kazandırır?

• Elle veri taşımanın bitmesi — Kopyala-yapıştır ile yürüyen aktarımlar ortadan kalkar; kazanılan zaman doğrudan ölçülebilir.
• Tutarlı veri — Aynı bilgi her sistemde aynı görünür. Raporların birbirini tutmaması sorunu kaynağında çözülür.
• Daha az hata — Elle giriş, hatanın en büyük kaynağıdır. Otomatik akışta kurallar bir kez tanımlanır ve her seferinde aynı çalışır.
• Hız — Sipariş, stok ve ödeme bilgisi dakikalar içinde ilgili sisteme ulaşır; gün sonu beklenmez.
• Görünürlük — Akışların çalışıp çalışmadığı izlenebilir. Bir sorun, müşteri şikâyetiyle değil bildirimle öğrenilir.
• Mevcut yatırımın korunması — Sistemleri değiştirmek yerine birbirine bağlamak, çoğu durumda hem daha hızlı hem daha az risklidir.

İyi kurulmuş bir entegrasyon fark edilmez; kötü kurulmuş olan ise her ay kendini hatırlatır. Hedefimiz, kurulduktan sonra kimsenin düşünmek zorunda kalmadığı, bozulduğunda ise kendini haber veren akışlar bırakmaktır.