API Nedir? API Entegrasyonu Nasıl Yapılır?

Özel Yazılım · 10 Eki 2026

API nedir, nasıl çalışır? REST, SOAP ve webhook farkı, ERP, e-fatura ve kargo entegrasyonu örnekleri, proje adımları ve güvenlik kontrol listesi.

API (Application Programming Interface, uygulama programlama arayüzü), iki yazılımın birbiriyle önceden tanımlanmış kurallarla konuşmasını sağlayan bağlantı noktasıdır. Bir yazılım “şu siparişin durumunu ver” diye istek gönderir, diğeri cevabı belirli bir biçimde döner. API entegrasyonu ise bu bağlantıyı kullanarak şirketin sistemlerini (ERP, CRM, e-ticaret, e-fatura, kargo) birbirine bağlamak ve veriyi elle taşımaya son vermektir.

API’yi bir restorandaki garsona benzetebilirsiniz: siz mutfağa girmezsiniz, siparişi garsona verirsiniz, garson da mutfaktan yemeği getirir. Mutfağın nasıl çalıştığını bilmeniz gerekmez; yalnızca menüyü (API’nin belgelerini) bilmeniz yeterlidir. Bu yazıda API’nin nasıl çalıştığını, türlerini, işletmeler için en yaygın entegrasyon örneklerini ve bir API entegrasyon projesini güvenle nasıl yürüteceğinizi anlatıyoruz.

API nasıl çalışır?

Bir API çağrısı dört parçadan oluşur:

• Adres (endpoint): İsteğin gönderildiği yer, örneğin bir kargo firmasının gönderi sorgulama adresi.
• Yöntem: Ne yapılmak istendiği. Okumak için GET, yeni kayıt oluşturmak için POST, güncellemek için PUT ya da PATCH, silmek için DELETE kullanılır.
• Kimlik doğrulama: İsteği gönderenin yetkili olduğunu kanıtlayan anahtar ya da belirteç (token).
• Veri: Gönderilen ve dönen bilgi. Günümüzde çoğunlukla JSON biçimindedir.

Örneğin e-ticaret sitenizde bir sipariş oluştuğunda site, ERP’nizin API’sine “bu müşteri, bu ürünlerden, bu adede sipariş verdi” bilgisini POST ile gönderir. ERP siparişi kaydeder ve sipariş numarasını geri döner. Ardından ERP, kargo firmasının API’sine gönderi oluşturma isteği yapar ve takip numarasını alır. Bu zincirde hiçbir insan veri girmez.

API türleri nelerdir?

Erişim açısından da üç tür vardır: herkese açık (public) API’ler, iş ortaklarına açılan (partner) API’ler ve yalnızca şirket içinde kullanılan özel (private) API’ler.

İşletmeler API entegrasyonunu nerede kullanır?

Ortak nokta şudur: bugün bir çalışanın bir ekrandan okuyup başka bir ekrana yazdığı her bilgi, bir API entegrasyonu adayıdır.

API entegrasyonu projesi nasıl yürütülür?

1. Veri akışını çizin. Hangi bilgi, hangi sistemden hangisine, hangi olayda ve ne sıklıkla gidecek? Hangi sistem hangi verinin “asıl kaynağı” olacak?
2. API belgelerini inceleyin. Her sistemin API’si gerekli işlemleri destekliyor mu? İstek sınırları (rate limit), kimlik doğrulama yöntemi ve test ortamı var mı?
3. Alan eşlemesi yapın. Bir sistemdeki “müşteri kodu” ötekinde hangi alana karşılık geliyor? Birimler, para birimi, vergi oranları ve tarih biçimleri nasıl dönüştürülecek?
4. Hata senaryolarını tasarlayın. Karşı sistem cevap vermezse, veri eksikse ya da aynı istek iki kez giderse ne olacak? Yeniden deneme ve çift kayıt önleme kuralları baştan yazılmalıdır.
5. Test ortamında geliştirin. Gerçek veriye dokunmadan önce tüm akış test ortamında denenir.
6. İzleme ve uyarı kurun. Başarısız her istek kayda geçmeli, sorumlu kişiye bildirim gitmeli ve düzeltildikten sonra yeniden gönderilebilmelidir.
7. Aşamalı canlıya alın. Önce düşük hacimle başlayın, sonuçları elle karşılaştırın, ardından tam hacme geçin.

API güvenliği için kontrol listesi

API’ler şirket verisine açılan kapılardır. Bir entegrasyonu canlıya almadan önce şu maddeleri kontrol edin:

• Tüm trafik HTTPS üzerinden şifreli gidiyor.
• API anahtarları kodun içine yazılmamış, güvenli bir yerde saklanıyor ve düzenli olarak yenileniyor.
• Her entegrasyonun yetkisi yalnızca ihtiyaç duyduğu işlemle sınırlı (salt okuma yetecekse yazma verilmiyor).
• Gelen veri doğrulanıyor; beklenmeyen alan ve değerler reddediliyor.
• İstek sayısına sınır konmuş; kötüye kullanım ve aşırı yüklenme engelleniyor.
• Kişisel veriler yalnızca gerektiği kadar aktarılıyor ve KVKK açısından kayıt altında.
• Tüm istekler kim, ne zaman, ne yaptı bilgisiyle loglanıyor.
• Webhook’larda gelen isteğin gerçekten beklenen sistemden geldiği imza ile doğrulanıyor.

API entegrasyonunda en sık hangi hatalar yapılır?

Entegrasyonlar çoğu zaman ilk gün çalışır. Sorunlar haftalar sonra, beklenmedik bir veri ya da yoğun bir gün geldiğinde ortaya çıkar. En sık gördüğümüz hatalar şunlardır:

• Asıl kaynağın belirsiz kalması: Stok hem e-ticaret sitesinde hem ERP’de elle değiştirilebiliyorsa iki sistem birbirinin verisini ezer. Her veri için tek bir asıl kaynak seçilmelidir.
• Çift kayıt: Ağ kesintisinden sonra aynı sipariş iki kez gönderilir ve iki fatura kesilir. Her isteğe benzersiz bir kimlik verilerek tekrarlar ayıklanmalıdır.
• Sessiz hatalar: Başarısız istekler yalnızca bir log dosyasına yazılır, kimse görmez. Hata ancak müşteri şikayet ettiğinde fark edilir.
• Sürüm değişikliklerinin izlenmemesi: Karşı taraf API’sini güncellediğinde eski sürüm kapanır ve entegrasyon bir gün aniden durur. Sağlayıcıların sürüm duyuruları takip edilmelidir.
• Toplu işlerin sınıra takılması: Binlerce ürünün fiyatı aynı anda güncellenirken istek sınırı aşılır ve işlemin bir kısmı yarım kalır. Toplu işler parçalara bölünmelidir.

Bir entegrasyon projesine nasıl başlıyoruz?

Crayn olarak bir entegrasyon talebinde kod yazmadan önce ilk iş, bugün elle yapılan işi adım adım izlemektir. Kim, hangi ekrandan hangi bilgiyi alıyor, nereye yazıyor, ne sıklıkla ve ne kadar sürede? Bu tablo hem entegrasyonun kapsamını hem de kazanılacak zamanı somut hale getirir.

Ardından bağlanacak her sistemin API belgelerini ve test ortamını kontrol ederiz. Belgesi eksik ya da test ortamı olmayan bir sistem, takvimdeki en büyük risktir; bunu baştan söylemek sonradan sürpriz yaşamaktan iyidir. Son olarak hata durumunda kimin uyarı alacağını ve elle müdahalenin nasıl yapılacağını işletmeyle birlikte belirleriz. Entegrasyonu canlıya aldıktan sonra ilk haftalarda sonuçları elle yapılan kayıtlarla karşılaştırırız.

API’si olmayan bir sistemle nasıl entegrasyon yapılır?

Eski ya da kapalı sistemlerde API bulunmayabilir. Bu durumda üç yol vardır. Birincisi, sistemin veritabanına doğrudan ve dikkatli bir şekilde (tercihen salt okuma ile) bağlanmaktır. İkincisi, sistemin dosya dışa ve içe aktarma özelliklerini (CSV, XML) otomatik bir akışla kullanmaktır. Üçüncüsü ise RPA ile ekran üzerinden işlem yapan bir yazılım robotudur. Üçü de çalışır ama bakım yükleri API’ye göre daha yüksektir. Uzun vadede bu sistemin önüne küçük bir API katmanı yazmak çoğu zaman en sağlıklı çözümdür.

Sık sorulan sorular

API ile entegrasyon arasındaki fark nedir?

API, bir yazılımın dışarıya sunduğu bağlantı noktasıdır. Entegrasyon ise bu bağlantı noktalarını kullanarak iki ya da daha fazla sistemi bir iş akışında birleştirme işidir. API kapıdır, entegrasyon o kapıdan geçen düzenli trafiktir.

API entegrasyonu için yazılım bilgisi gerekir mi?

Basit bağlantılar için n8n gibi akış otomasyonu araçları kod yazmadan kurulabilir. Alan dönüşümleri, hata yönetimi ve yüksek hacim gerektiren entegrasyonlar ise yazılım ekibi işidir. Kritik veriler taşınıyorsa profesyonel destek almak riski ciddi ölçüde azaltır.

API entegrasyonu ne kadar sürer?

İki sistem arasında, belgeleri iyi olan API’lerle yapılan bir entegrasyon genellikle birkaç gün ile birkaç hafta arasında tamamlanır. Belgesiz API’ler, eski sistemler ve karmaşık alan eşlemeleri süreyi uzatır.

API kullanmak ücretli mi?

Sisteme göre değişir. Bazı yazılımlar API erişimini paketlerine dahil eder, bazıları üst paketlerde sunar ya da istek sayısına göre ücretlendirir. Entegrasyon planlanırken her sistemin API ücretlendirmesi ve istek sınırları kontrol edilmelidir.

Kendi yazılımımız için API yazmalı mıyız?

Yazılımınızla başka sistemlerin, iş ortaklarının ya da bir mobil uygulamanın konuşması gerekiyorsa evet. İyi belgelenmiş bir API, yazılımınızı gelecekteki tüm entegrasyonlara açık hale getirir ve tek bir sisteme bağımlı kalmanızı önler.

Sistemlerinizi birbirine bağlayan entegrasyonlar ve kendi ürününüz için API geliştirmek üzere özel yazılım geliştirme sayfamıza bakabilirsiniz. Entegrasyonu bir iş akışına dönüştürmek için süreç otomasyonuna nereden başlanır, bağlanacak çekirdek sistemi tanımak için de ERP nedir? yazılarımızı okuyabilirsiniz.