Farklı Sistemlerini Tek API ile Birleştirmek İsteyenler İçin API Geliştirme
ERP, CRM, e-ticaret ve muhasebe programınız tek tek çalışıyor olabilir; sorun aralarındaki boşlukta. Her veri için tek doğruluk kaynağını belirliyor, aralarına çift yönlü ve olay tabanlı çalışan bir API katmanı kuruyoruz. Aynı veriyi iki yere girme dönemi burada bitiyor.
- Alan eşleme tablosu teslim edilir
- OpenAPI + Postman dokümantasyonu
- Logo ERP çözüm ortağı
- Kaynak kod ve veri şeması sizin
Sistemler doğru; aralarındaki boşluk yanlış.
Entegrasyon ihtiyacı genellikle tek bir arıza ile değil, biriken küçük tutarsızlıklarla fark ediliyor. Aşağıdakiler, birden fazla sistemi aynı anda kullanan şirketlerde en sık karşımıza çıkan tablolar.
- Aynı müşteri üç sistemde üç farklıCari kart ERP'de, iletişim bilgisi CRM'de, teslimat adresi e-ticarette güncelleniyor. Hangisinin doğru olduğunu kimse net söyleyemiyor.
- Stok bilgisi her yerde geriden geliyorDepoda kalmayan ürün sitede satılmaya devam ediyor. İptal ve iade süreci, entegrasyonun maliyetinden daha pahalıya geliyor.
- Gün sonu aktarımı bir kişinin işiBirisi her akşam dosya indirip diğer sisteme yüklüyor. O kişi izne çıktığında iki sistem arasındaki fark büyümeye başlıyor.
- Fiyat farkları müşteriye yansıyorKampanya fiyatı bir sistemde güncellenip diğerinde unutulunca, faturadaki tutarla siparişteki tutar tutmuyor.
- Rapor sistemlerin toplamı değilHer sistem kendi raporunu üretiyor; yönetim tablosu üç raporu elle birleştirerek çıkıyor ve çoğu zaman geç kalıyor.
- Yeni sistem eklemek her seferinde sıfırdan işHer yeni araç için ayrı bir bağlantı yazılıyor. Beş sistem arasında noktadan noktaya bağlantı sayısı hızla yönetilemez hale geliyor.
Önce sözlük, sonra kod.
Entegrasyon projelerinin çoğu teknik nedenlerle değil, hangi verinin kimin sorumluluğunda olduğu kararlaştırılmadığı için zorlanıyor. Biz bu kararı ilk haftada masaya koyuyoruz.
- Sistem envanteriHangi sistem var, hangisi dışarıya ne veriyor, hangi veriyi kabul ediyor — hepsini tek tabloda çıkarıyoruz. Bağlantı yöntemi bu tabloya göre seçiliyor.TeslimSistem listesiErişim yöntemi notuKısıt ve limit tespiti
- Tek doğruluk kaynağı kararıCari, ürün, fiyat, stok, sipariş ve fatura için hangi sistemin sahibi olduğunu birlikte belirliyoruz. Bu karar olmadan yazılan entegrasyon, çakışmayı büyütür.TeslimVeri sahipliği tablosuAlan eşleme listesiÇakışma kuralları
- API katmanı tasarımıSistemler birbirine doğrudan değil, ortadaki katmana bağlanıyor. Sözleşme OpenAPI ile yazılıyor; her iki taraf da aynı belgeye bakıyor.TeslimOpenAPI sözleşmesiKimlik doğrulama tasarımıSandbox ortamı
- Bağlayıcıların geliştirilmesiHer sistem için ayrı bir bağlayıcı yazılıyor. Bir sistem değiştiğinde yalnız kendi bağlayıcısı güncelleniyor, diğer akışlar etkilenmiyor.TeslimSistem başına bağlayıcıRetry ve kuyruk yapısıTest senaryoları
- İzleme ve devirCanlıya alma kademeli yapılıyor: önce tek yön, doğrulandıktan sonra çift yön. Kapanışta izleme panosu ve dokümantasyon teslim ediliyor.Teslimİzleme panosuPostman koleksiyonuEkip devir oturumu
Veri akış haritanızı 60 saniyede çıkarın
Kullandığınız sistemleri işaretleyin, her veri için sahibini seçin. Ekranda hangi verinin nereden nereye akacağını, kaç bağlantı noktası gerektiğini ve hangi kararların hâlâ açık olduğunu görün. Hiçbir veri kaydedilmez; hesap tarayıcınızda yapılır.
- Cari / müşteri kartıHenüz karar verilmedi
- Ürün ve kategoriHenüz karar verilmedi
- Fiyat ve iskontoHenüz karar verilmedi
- Stok miktarıHenüz karar verilmedi
- SiparişHenüz karar verilmedi
- Fatura / irsaliyeHenüz karar verilmedi
- Sahibi belirlenmemiş veri, iki sistemde birden değiştirilebilir. Çakışmanın en sık nedeni budur.
Buradaki akış sayısı, seçtiğiniz veri ve sistem sayısından türetilen örnek bir büyüklük göstergesidir; süre veya fiyat tahmini değildir. Gerçek kapsam, her sistemin dışarıya ne verdiğine ve alan eşlemesinin derinliğine göre keşif görüşmesinde netleşir.
Birleştirme projesinde neler kuruluyor?
Aşağıdakiler bir paket değil, bir menü. İlk fazda genellikle iki üç akış açılıyor; kalanı veri akışı oturdukça aynı katmanın içine ekleniyor.
- ÇekirdekSistem bağlayıcılarıHer sistem için ayrı, değiştirilebilir bağlayıcı. Bir sistem değişirse yalnız o parça yeniden yazılır.
- ÇekirdekAlan eşleme katmanıFarklı isimlendirmeleri ortak bir sözlüğe çeviren dönüşüm kuralları; birim ve para birimi çevrimi dahil.
- SenkronOlay tabanlı tetiklemeDeğişiklik olduğunda webhook ile anında iletim; periyodik tarama yerine olay dinleme.
- DayanıklılıkKuyruk ve yeniden denemeKarşı sistem yanıt vermediğinde işlem kaybolmaz; kuyrukta bekler, artan aralıklarla yeniden denenir.
- DayanıklılıkIdempotency korumasıAynı olay iki kez geldiğinde ikinci kayıt oluşmaz; mükerrer sipariş ve fatura önlenir.
- KontrolÇakışma ve onay ekranıOtomatik çözülemeyen eşleşmeler bir listeye düşer; kararı sizin ekibiniz verir.
- Operasyonİzleme ve uyarı panosuHangi akış en son ne zaman çalıştı, kaç kayıt aktarıldı, kaç hata var — tek ekranda.
- TeslimOpenAPI ve Postman teslimiCanlı Swagger dokümanı ve hazır istek koleksiyonu; ekibiniz ilk gün deneyebilir.
Servis katmanını Node.js ile, veri tarafını genellikle PostgreSQL ile kuruyoruz; kuyruk ve önbellek için Redis kullanıyoruz. Protokol tarafında varsayılan tercihimiz REST + OpenAPI; istemci çok sayıda farklı alanı tek istekte istiyorsa GraphQL değerlendiriyoruz. Yaklaşımın tamamını API geliştirme hizmet sayfasında bulabilirsiniz.
Logo tarafında bu işi uzun süredir yapıyoruz: Logo ERP çözüm ortaklığı kapsamında cari, stok, fiyat okuyan ve belge geri yazan bağlantılar kuruyoruz. Alan eşleme ve senkronizasyon kararlarını ayrıntılı anlatan Logo ERP entegrasyonu rehberimiz projeye başlamadan önce okunmaya değer. Kendi ürünümüz TYS — Teklif Yönetim Sistemi tam olarak bu ihtiyaçtan doğdu.
Entegrasyon çalışırken değil, bozulduğunda belli olur.
İyi kurulmuş bir entegrasyonun farkı mutlu senaryoda görünmez. Fark, karşı sistem yanıt vermediğinde, aynı olay iki kez geldiğinde veya bir alan beklenmedik bir değer taşıdığında ortaya çıkar.
- Karşı sistem yanıt vermiyorİşlem kuyrukta bekler, artan aralıklarla yeniden denenir. Belirlenen deneme sayısı aşılırsa kayıt ayrı bir listeye düşer ve uyarı gider.
- Aynı olay iki kez geldiHer olayın benzersiz bir anahtarı vardır; daha önce işlenmişse ikinci istek kayıt oluşturmadan başarılı sayılır.
- Alan beklenmedik değer taşıyorDoğrulama katmanı kaydı karşı sisteme göndermeden durdurur; hata mesajı hangi alanda ne beklendiğini söyler.
- İki taraf aynı anda değiştiSahiplik kuralı devreye girer: sahip sistemin değeri kazanır, diğer değişiklik çakışma listesine düşer.
Bu davranışların hepsi kabul kriterlerine yazılır ve teslim öncesi sandbox ortamında birlikte test edilir. Böylece canlıda ilk kez karşılaşılan bir senaryo kalmaz.
Örnek bir ilk faz: iki sistem, üç veri
Aşağıdaki plan, iki sistemin bağlandığı ve üç veri türünün senkronlandığı tipik bir ilk faz için hazırlanmış örnektir. Sizin planınız kapsam netleştikten sonra çıkar ve sözleşmede yazılı tarihe bağlanır.
| Hafta | Ne yapılır | Hafta sonunda elinizde ne olur |
|---|---|---|
| 1. hafta | Sistem envanteri ve erişim | Sistem tablosu, test erişimleri |
| 2. hafta | Veri sahipliği ve alan eşleme | Eşleme tablosu, çakışma kuralları |
| 3. hafta | API sözleşmesi | OpenAPI taslağı, sandbox |
| 4–5. hafta | Bağlayıcı geliştirme | Çalışan tek yönlü akış |
| 6. hafta | Çift yön ve hata senaryoları | Retry, kuyruk, çakışma ekranı |
| 7. hafta | Gerçek veriyle deneme | Kontrollü canlı geçiş, düzeltmeler |
| 8. hafta | İzleme ve devir | Pano, Postman, ekip oturumu |
İlk faz kapandıktan sonra kalan sistemler, aynı katmana yeni bağlayıcılar eklenerek devreye alınıyor; ortadaki sözleşme değişmediği için her ekleme öncekinden kısa sürüyor.
- HizmetAPI GeliştirmeHizmetin tamamı: kapsam, süreç, teslimatlar ve teknoloji yığını.
- HizmetLogo ERP Çözüm OrtaklığıLogo ürünleriyle entegrasyon, danışmanlık ve destek tarafı.
- HizmetWeb Yazılım GeliştirmeEntegrasyon katmanının üstüne oturan iş uygulamaları.
- HizmetTeknik DanışmanlıkMimari ve sistem kararlarında bağımsız değerlendirme.
- ProjeTYS — Teklif Yönetim SistemiLogo entegre teklif ve onay yönetimi; kendi ürünümüz.
- RehberLogo ERP entegrasyonu: e-ticaret ve B2B rehberiAlan eşleme, senkronizasyon ve sık yapılan hatalar.
- RehberYazılım firması seçerken dikkat edilmesi gerekenlerEntegrasyon teklifi karşılaştırırken sorulacak sorular.
- RehberWeb hosting, VPS, bulut ve dedicated farkıEntegrasyon katmanının nerede çalışacağına karar verirken.
Sık sorulanlar
Bağlantı yöntemi, veri sahipliği, senkron sıklığı ve hata yönetimi hakkında en çok sorulanlar.
Hangi veriden başlayacağımızı birlikte belirleyelim
Sistemlerinizi ve bugün elle aktardığınız verileri anlatın; ilk görüşmede en çok zaman kaybettiren akışı tespit edip gerçekçi bir ilk faz kapsamı çıkaralım. Keşif görüşmesi ücretsizdir ve sizi bağlamaz.
- ✓ Keşif görüşmesi ücretsiz
- ✓ Kapsam netleşmeden fiyat vermiyoruz
- ✓ Alan eşleme tablosu teslimata dahil
Aynı veriyi iki kez girme dönemini kapatalım
Sistem envanteriyle başlıyor, veri sahipliğini karara bağlıyor ve aralarına tek bir API katmanı kuruyoruz. Nereden başlayacağınızı birlikte belirleyelim.