API entegrasyonu, iki yazılımın birbiriyle konuşmasını sağlayan bağlantıdır. Pratikte anlamı şu: aynı veriyi iki farklı programa elle girmeyi bırakmak. Bu yazı ne zaman gerektiğini, nasıl kurulduğunu ve nelerin ters gittiğini anlatıyor.
API nedir, ne değildir?
API (Application Programming Interface), bir yazılımın dışarıya açtığı kapıdır: "şu adrese şu formatta sorarsan, sana şu veriyi veririm" sözleşmesi. Kullanıcı arayüzü insan içindir; API başka bir yazılım içindir.
Yaygın bir yanlış anlama: API entegrasyonu sadece "veri çekmek" değil. Asıl iş, iki sistemin veri modellerini eşleştirmek ve hata durumlarını yönetmek.
Ne zaman gerekir?
Şu belirtiler varsa entegrasyon gerekçesi oluşmuştur:
- Aynı bilgi iki programa elle giriliyor (sipariş → muhasebe, stok → site)
- İki sistem arasında Excel dosyası taşınıyor
- Gün sonunda "hangi kayıt aktarıldı" kontrolü yapılıyor
- Bir sistemdeki değişiklik diğerine geç yansıdığı için hata çıkıyor
- Ekip zamanının önemli bölümü veri taşımaya gidiyor
Buna karşılık günde 5 kaydın taşındığı bir yerde entegrasyon maliyeti geri dönmez. Kabaca eşik: haftada 3 saatin üzerinde manuel aktarım.
En sık kurulan entegrasyonlar
| Bağlantı | Ne kazandırır |
|---|---|
| E-ticaret → muhasebe | Sipariş ve fatura otomatik aktarılır |
| E-ticaret → kargo | Barkod, takip numarası, müşteri bildirimi |
| Site/panel → ERP | Stok, cari, fiyat tek merkezden |
| Pazaryeri → panel | Trendyol, Hepsiburada siparişleri tek ekranda |
| CRM → e-posta/SMS | Otomatik bilgilendirme ve kampanya |
| Banka → muhasebe | Ekstre ve tahsilat eşleştirme |
Nasıl kurulur: 6 adım
1. Veri eşleme tablosu
Kod yazılmadan önce yapılacak tek şey: iki sistemdeki alanların yazılı olarak eşleştirilmesi. "Ürün kodu" bir sistemde SKU, diğerinde barkod olabilir. Bu tablo hazırlanmadan yazılan entegrasyon her zaman sonradan düzeltiliyor.
2. Veri yönü ve otorite
Hangi sistem hangi veri için "doğruyu söyler"? Stok için depo, fiyat için ERP, müşteri için CRM gibi. Bu tanımlanmazsa iki sistem birbirinin verisini ezer.
3. Kimlik doğrulama ve yetki
API anahtarları kod içine yazılmamalı, ortam değişkeninde tutulmalı ve yetkileri gerektiği kadar dar olmalı. Salt okunur bir işlem için yazma yetkisi istemeyin.
4. Hata yönetimi
Entegrasyonun kalitesini belirleyen asıl kısım burası. Karşı sistem cevap vermediğinde:
- Kayıt kaybolmamalı, kuyrukta beklemeli
- Belirli aralıklarla tekrar denenmeli (üstel geri çekilme)
- Belirli sayıda denemeden sonra sorumluya bildirim gitmeli
- Her deneme loglanmalı
Bu dördü yoksa entegrasyon "çalışıyor gibi" görünüp aylar sonra fark edilen kayıplar üretir.
5. Test ortamı
Denemeler canlı sistemde yapılmamalı. Gerçek müşteriye gerçek SMS gitmesi, sahte siparişlerin muhasebeye düşmesi bu yüzden oluyor.
6. Kademeli geçiş
Önce tek kanal veya tek işlem tipi. İlk hafta her kayıt elle doğrulanır. Sorun çıkarsa etkisi sınırlı kalır.
Teknik notlar
- REST ve JSON en yaygın standart; çoğu modern sistem bunu konuşuyor.
- Webhook, karşı sistemin olay olduğunda sizi çağırması demek — sürekli sorgulamaktan (polling) hem hızlı hem ucuz.
- Kuyruk yapısı, isteklerin arka planda işlenmesini sağlar; sipariş kaydını API cevabını bekleyerek yapan kurulumlar hem yavaş hem kırılgan olur.
- Hız limiti (rate limit), çoğu API'de var. Toplu aktarımlarda buna uymak gerekiyor.
- Sürüm yönetimi: karşı sistem API'sini güncellediğinde entegrasyonun kırılmaması için sürüm sabitlemesi ve izleme şart.
Eski sistemler ne olacak?
Türkiye'de en sık karşılaşılan durum: muhasebe programının API'si yok veya çok sınırlı. Seçenekler:
- Ara veri tabanı: Program kendi veri tabanına yazıyorsa oradan okumak
- Dosya bazlı aktarım: Belirli aralıklarla CSV/XML üretip okumak
- Sağlayıcının entegrasyon modülü: Ek ücretli ama en güvenli
- Yükseltme: Bazen en ekonomik yol programın güncel sürümüne geçmek
Bu vakalarda efor, belgelenmiş bir API'ye bağlanmaya göre 2–3 kat artıyor. Teklif alırken karşı sistemin sürümünü ve API durumunu net söyleyin.
Süre ve maliyet
| Kapsam | Süre | Bütçe |
|---|---|---|
| Tek yönlü tek akış | 1–2 hafta | 8.000–20.000 TL |
| Çift yönlü, 2–3 veri tipi | 3–5 hafta | 25.000–60.000 TL |
| ERP / eski sistem bağlantısı | 6–10 hafta | 60.000–150.000 TL |
Değişkenliğin ana sebebi karşı sistemin API kalitesi. Belgelenmiş güncel bir API ile eski bir programın veri tabanına bağlanmak arasında büyük fark var.
Sık sorulan sorular
Entegrasyon sistemimi yavaşlatır mı?
Doğru kurulduğunda hayır. Aktarımlar arka planda kuyruk üzerinden yapılmalı.
Karşı taraf API'sini değiştirirse ne olur?
İzleme kurulmuşsa hemen fark edilir. Bu yüzden bakım sözleşmesi entegrasyonun parçası olmalı.
Veri güvenliği nasıl sağlanıyor?
HTTPS, dar yetkili anahtarlar, ortam değişkeninde saklama ve kişisel veri aktarımında KVKK uyumu. Log kayıtlarında kart ve kimlik bilgisi tutulmamalı.
Kaç sistem birbirine bağlanabilir?
Sınır yok ama ikiden fazla sistemde merkezî bir yapı kurmak (herkesin herkese bağlanması yerine) bakımı çok kolaylaştırıyor.
Başlamak için
Hangi iki sistemi bağlamak istediğinizi ve hangi verinin akacağını yazın; kapsamı ve süreyi ücretsiz çıkarıyoruz. Hizmet detayı için API entegrasyonu sayfasına, e-ticaret tarafı için OpenCart API entegrasyonu yazısına bakabilirsiniz.
Telefon / WhatsApp: +90 536 628 0007
E-posta: info@enextware.com