İçeriğe geç
aywebyazilim

Hizmet

API ve Sistem Entegrasyonları

ERP, CRM, muhasebe, ödeme ve üçüncü taraf servislerinizi güvenli API entegrasyonlarıyla birbirine bağlayın.

Bir işletmede nadiren tek bir yazılım vardır. Site ayrı, panel ayrı, muhasebe ayrı, üretim yazılımı ayrı çalışır. Bu sistemler birbiriyle konuşmadığında aradaki boşluğu insan doldurur: aynı veri iki yere elle girilir, bir dosya indirilip diğerine yüklenir.

Entegrasyon, bu elle taşıma işini ortadan kaldırmaktır. Ama işin zor kısmı bağlantıyı kurmak değil, bağlantı koptuğunda ne olacağına karar vermektir. Odağımız burada: kuyruk, tekrar deneme, aynı kaydın iki kez işlenmemesi ve her aktarımın izlenebilir olması.

Bağlantı her zaman modern bir API üzerinden kurulmaz. Karşı taraf yalnızca dosya üretiyorsa dosyayı okuruz; bir servis kesin veri değil tahmin döndürüyorsa tahmin olduğunu gizlemeyiz. Yöntem ihtiyaca göre değişir, kural değişmez: veri tek bir yerde doğru olmalı ve hata sessiz kalmamalıdır.

Kazanım

Bu hizmet ne kazandırır

Nasıl çalışır

Projenin akışı

  1. 01

    Veri sözlüğü

    Hangi alanın hangi sistemde hangi adla durduğunu tek tabloda eşleriz; birim ve format farkları burada ortaya çıkar.

  2. 02

    Yön ve tetikleyici kararı

    Akışın tek yönlü mü çift yönlü mü olacağını, anlık mı zamanlanmış mı çalışacağını yazılı olarak kararlaştırırız.

  3. 03

    Kimlik doğrulama ve test ortamı

    Erişim anahtarlarını alır ve mümkünse karşı tarafın test ortamında çalışırız; canlı veriyle deneme yapmayız.

  4. 04

    Hata senaryoları

    Servis cevap vermezse, alan boş gelirse veya format değişirse ne olacağını geliştirmeden önce tanımlarız.

  5. 05

    Kuyruk ve tekrar-koruma

    Aktarımları kuyruğa alır, başarısız işleri yeniden dener ve her kaydı tekil anahtarla işaretleriz.

  6. 06

    İzleme ve devreye alma

    Her aktarımın durumunu kayda geçirir, kalıcı hatalar için bildirim kurar ve akışı canlıya alırız.

01

Entegrasyon üç soruyla başlar

Teknik tercihten önce cevaplanması gereken üç soru var. Bu sorular cevaplanmadan yazılan entegrasyon, ilk ay içinde yeniden yazılır.

  • Hangi veri? Alan alan eşleme yapılır: müşteri kodu iki sistemde de aynı mı, birimler aynı mı, tarih ve ondalık ayırıcı formatı ne?
  • Hangi yön? Çift yönlü akış kulağa hoş gelir ama çakışma riski taşır. Çoğu ihtiyaç için bir tarafın "sahip", diğerinin "okuyucu" olduğu tek yönlü akış daha sağlamdır.
  • Ne zaman? Anlık aktarım her zaman gerekli değildir. Belirli aralıklarla çalışan zamanlanmış bir aktarım çoğu iş için yeterlidir ve çok daha az kırılgandır.

Bu üç cevabı yazılı hâle getirmek, entegrasyon projelerinde teklif aşamasında yapılabilecek en yüksek getirili iştir.

02

Dosya da bir entegrasyondur

Karşı tarafta API olmadığında iş bitmez. Çoğu üretim yazılımı bir rapor üretir; o raporu okumak da bir entegrasyondur.

Kendi girişimimiz LazerCRM'de bu yolu kullanıyoruz: dizilim yazılımının ürettiği kesim listesi Word veya Excel olarak veriliyor, sistem dosyayı okuyup satırları kendisi dolduruyor.

  • Okuma sabit sütun sırasına bağlı değildir; başlıklar eşanlamlı adlarıyla eşleştirilir, başlık bulunamazsa konumsal yedeğe düşülür
  • İş kuralları dosyadan gelen veriye de uygulanır; hatalı eşleşme içeri sızmaz
  • Dosyadan gelen değer ile sonradan düzeltilen değer ayrı gösterilir, tek tıkla orijinaline dönülebilir

Kritik ayrım şu: dosya okumak "üçüncü sütunu al" demek değildir. Karşı taraf çıktısını değiştirdiğinde sessizce yanlış veri girmemesi için eşleme esnek, doğrulama katı olmalıdır.

03

Dış servisin çıktısı bir tahminse, tahmin olduğu söylenir

Bazı entegrasyonlar kesin veri değil tahmin döndürür. Görsel analiz servisleri bunun tipik örneğidir.

NDA kapsamındaki bir sağlık ve fitness uygulamasında, kullanıcının çektiği tabak fotoğrafı bir görsel analiz servisine gönderiliyor ve porsiyon tahmini yapılıyor. Tasarım kararımız, sonucu kesinmiş gibi göstermemek oldu:

  • Tahminin ne kadar güvenilir olduğu kullanıcıya açıkça gösterilir
  • Kullanıcı gramajı düzeltebilir; ilk tahmin ile düzeltilmiş toplam yan yana durur
  • Yapılan düzeltmeler kişisel bir porsiyon profiline dönüşür ve sonraki tahminlerin başlangıç değerini besler

Dış servisin çıktısını sorgusuz kabul eden bir entegrasyon, o servisin hatasını sizin sisteminizin içine taşır. Doğru yaklaşım, tahmini görünür ve düzeltilebilir hâle getirmektir.

04

Bağlantı koptuğunda ne olacak?

Entegrasyon projelerinin çoğu mutlu senaryoya göre yazılır ve ilk kesintide çöker. Biz kesinti senaryosunu baştan tasarlıyoruz.

  • Kuyruk: Gönderim doğrudan yapılmaz, kuyruğa alınır ve arka planda işlenir. Kullanıcı beklemez, hata ekranı görmez.
  • Tekrar deneme: Başarısız iş belirli aralıklarla yeniden denenir; kalıcı hatada bildirim çıkar.
  • Tekrar-koruma: İşlenen kayıt işaretlenir. Aynı istek iki kez gelse bile ikinci bir kayıt açılmaz.
  • Durum kaydı: Her aktarımın sonucu saklanır; hangi kayıt ne zaman, hangi durumla gitti sonradan görülebilir.

SARGE Mühendislik için geliştirdiğimiz raporlama akışında bu yapı kullanılıyor: analiz tamamlandığında PDF üretilip müşteriye e-posta ile gönderiliyor.

05

Yapamayacağımızı söylediğimiz yerler

Entegrasyonda "yaparız" demek kolaydır; asıl maliyet, yapılamayanın proje ortasında anlaşılmasıdır. Bu yüzden sınırları teklif aşamasında yazıyoruz.

  • API'si olmayan kapalı bir programa ekran kazıyarak bağlanmayı önermiyoruz. Bu yöntem, karşı taraf arayüzünü değiştirdiği gün sessizce bozulur. Dosya tabanlı aktarım daha sağlamdır.
  • Karşı tarafın dokümantasyonu ve test ortamı yoksa güvenilir bir süre tahmini veremeyiz. Bu, bizim değil karşı sistemin belirlediği bir risktir ve teklifte açıkça yazılır.
  • Anlık aktarım her zaman doğru cevap değildir. Gerçekten gerekli olduğunda kurarız; gerekmediğinde zamanlanmış aktarım öneririz, çünkü daha az kırılgandır.

Referanslar

Bu hizmeti verdiğimiz projeler

Sağlık ve Fitness Teknolojileri Gizli Müşteri · NDA

Kişiye Özel Kilo ve Kalori Takip Uygulaması (PWA)

Kullanıcının kendi ölçülerinden bazal metabolizmasını ve günlük kalori bütçesini hesaplayan, kişisel kilo haritası çıkaran; her sabahki tartıyı, ürün bazlı kalori girişini ve tabak fotoğrafından kalori tahminini tek yerde toplayan mobil öncelikli PWA uygulaması.

  • #PWA
  • #Mobil Uygulama
  • #Görsel Analiz
Endüstriyel Makine İmalatı SARGE Mühendislik

SARGE Mühendislik Kurumsal Web, Yatırım Analizi ve Raporlama Otomasyonu

Endüstriyel makine imalatçısı SARGE Mühendislik için; makine ve proje içeriklerinin panelden yönetildiği kurumsal web sitesi ile makine yatırımının insan gücüne karşı maliyetini, amortisman süresini ve beş yıllık getirisini hesaplayan yatırım analizi, müşteri takibi (CRM), üretim takibi ve otomatik PDF raporlama panelini geliştirdik.

  • #Yatırım Analizi
  • #CRM
  • #Üretim Takibi
Tarım Gizli Müşteri · NDA

KIO AGRI Kurumsal Web Sitesi ve Ürün Yönetim Sistemi

Tarım ve hayvancılık sektörüne yönelik yem karma makineleri üreten KIO AGRI için; ürün kataloğunu dinamik sunan kurumsal tanıtım sitesi ile envanterden üretime, sevkiyattan cari takibe tüm operasyonu tek platformda yöneten üretim ve satış yönetim sistemini (ERP) birlikte geliştirdik.

  • #Laravel
  • #ERP
  • #Üretim Takibi

Sık sorulanlar

Merak edilenler

Bağlanacağımız sistemin API'si yok, ne yapabiliriz?

Dosya tabanlı aktarım kurarız: karşı sistem rapor veya dışa aktarım üretiyorsa onu okuruz. Ekran kazıma (scraping) önermiyoruz; karşı taraf arayüzünü değiştirdiği gün sessizce bozulur ve bozulduğu fark edilmez.

Entegrasyon bozulursa haberimiz olur mu?

Evet. Her aktarım durumuyla kaydedilir ve kalıcı hatalarda bildirim gider. Bir entegrasyonun en tehlikeli hâli çalışmaması değil, çalışmadığının fark edilmemesidir.

Verilerimiz üçüncü tarafa gider mi?

Yalnız o entegrasyonun gerektirdiği alanlar, yalnız o servise gider. Hangi alanın nereye gittiği veri sözlüğünde yazılıdır ve iş başlamadan sizinle paylaşılır.

Aktarım anlık mı olmalı?

İhtiyaca bakarız. Stok ve fiyat gibi kritik alanlarda anlık aktarım mantıklıdır; sipariş ve rapor aktarımında belirli aralıklarla çalışan zamanlanmış bir akış hem yeterli hem daha az kırılgandır. Anlık aktarım kurulum ve bakım maliyetini artırır, bunu peşinen söylüyoruz.

Ne kadar sürer?

Süreyi büyük ölçüde karşı taraf belirler. Dokümantasyonu ve test ortamı hazır bir servise bağlanmak öngörülebilir bir iştir; dokümantasyonu olmayan bir sisteme bağlanmak deneme-yanılma demektir. Bu iki durumu teklifte ayrı ayrı yazıyoruz.

Projenizi konuşalım

İhtiyacınızı paylaşın; ekibimiz talebinizi inceleyip 1 iş günü içinde dönüş yapsın. Ön değerlendirme ücretsizdir, NDA’ya uygun çalışırız.