n8n API Entegrasyonu: 2026 İçin Şirket İçi Veri Akışını Otomatize Etmenin 7 Kritik Adımı

n8n API entegrasyonu kurarken çoğu ekip aynı hataya düşüyor: Önce karmaşık iş akışını çiziyor, sonra iki sistem arasında veri gidip gelmediğinde günlerce hata ayıklıyor. Geçen yıl kendi CRM’imiz ile muhasebe aracımız arasındaki fatura akışını otomatize ederken tam da bu noktada takılmıştık. Sonra fark ettik ki sorun koddan değil, entegrasyonun mantığını doğru kurgulamamaktan kaynaklanıyordu. Bu rehberde o gün öğrendiğimiz her şeyi, 2026’nın güncel n8n versiyonuyla ve gerçek bir şirket senaryosu üzerinden anlatacağım.

Okuyacağınız adımlar; CRM, ERP, e-ticaret, e-posta servisleri veya şirket içi veri tabanı gibi farklı sistemler arasında veri akışını kurarken doğrudan uygulayabileceğiniz bir yol haritası sunacak. Aradığınız cevabı hemen aşağıdaki özetten alabilirsiniz; detaylı kurulum ve hata çözümleri ise devamında sizi bekliyor.

n8n Nedir ve API Entegrasyonu Nasıl Çalışır?

n8n API entegrasyonu, n8n adlı açık kaynaklı otomasyon aracını kullanarak farklı yazılımların API uçlarını birbirine bağlama sürecidir. Kısa tanımıyla n8n; HTTP istekleri, Webhook’lar ve hazır düğümler aracılığıyla sistemler arası veri alışverişini görsel bir akış şeması üzerinde yapmanızı sağlayan bir iş akışı otomasyon platformudur.

2026 itibarıyla n8n’in popülerliği hızla artıyor. GitHub’da 100.000’i aşkın yıldız alan proje, Zapier ve Make’e kıyasla özellikle veri gizliliğine önem veren şirketler için öne çıkıyor. Bunun en büyük nedeni, n8n’i kendi sunucunuzda barındırabilmeniz. Yani API anahtarlarınız ve müşteri verileriniz üçüncü parti bir buluta gitmek zorunda kalmıyor.

n8n’in API Entegrasyonundaki Avantajları

n8n’i diğer otomasyon araçlarından ayıran birkaç kritik avantaj var. Birincisi, neredeyse her API servisine bağlanabilmesi. İkincisi ise veri dönüştürme esnekliği. Hazır bir düğüm olmasa bile HTTP Request düğümü ve JavaScript düğümü ile hemen her API’yi konuşturabilirsiniz.

• Açık kaynak ve self-host seçeneği: Verilerinizi kendi altyapınızda tutarsınız.
• 700’den fazla hazır entegrasyon: Slack, Google Sheets, WooCommerce, Telegram gibi popüler servislere hızlı bağlantı.
• Kod esnekliği: JavaScript veya Python ile özel dönüşümler yapabilirsiniz.
• Maliyet avantajı: Self-host edildiğinde işlem başına ücret ödemezsiniz; yalnızca sunucu maliyeti oluşur.

Özetle: n8n, şirket içi veri akışını otomatize etmek için güçlü bir orkestrasyon katmanıdır. Peki bu katman nasıl kurulur? İlk adım, HTTP isteğinin doğru kurgulanmasından geçiyor.

n8n’de HTTP Request ile API Entegrasyonunun Temelleri

HTTP Request düğümü, n8n API entegrasyonu sürecinin bel kemiğidir. Bir API’ye veri göndermek veya API’den veri çekmek istediğinizde kullanacağınız ilk ve en önemli düğüm budur. Çalışma mantığı basittir: Bir URL’ye istek atar, dönen yanıtı iş akışında bir sonraki adıma taşır.

Bu düğümü doğru kullanmak için REST API kavramlarını bilmek gerekir. En yaygın istek yöntemleri şunlardır:

HTTP Request Düğümünü Yapılandırma

n8n’de yeni bir iş akışı açtığınızda, sağ üstteki “+” işaretine basıp “HTTP Request” düğümünü arayın. Ardından aşağıdaki alanları doldurun:

1. Method: GET, POST, PUT gibi doğru yöntemi seçin.
2. URL: API uç noktasını yazın. Örneğin: https://api.orneksirket.com/v1/customers
3. Authentication: API’nizin istediği kimlik doğrulama tipini seçin (Generic Credential Type altında).
4. Send Headers: Content-Type: application/json gibi başlıkları ekleyin.
5. Send Body: POST veya PUT isteklerinde JSON formatında veri gönderin.

Bu düğümün çıktısını görmek için “Execute Node” butonuna basın. Yanıt JSON formatında dönerse, n8n bu veriyi otomatik olarak parçalara ayırır. Bir sonraki düğümde bu alanları doğrudan kullanabilirsiniz.

{
  "id": 1024,
  "email": "ornek@sirket.com",
  "full_name": "Ahmet Yılmaz",
  "status": "active"
}

Bu JSON çıktısı, bir sonraki adımda veritabanına yazılabilir veya farklı bir API’ye gönderilebilir. İşte entegrasyonun temel mantığı budur: Bir sistemden gelen veriyi al, dönüştür, diğerine aktar.

Sık Yapılan HTTP İstek Hataları

HTTP Request düğümünde en çok karşılaşılan sorunların başında 401 ve 404 hataları gelir. 401, kimlik doğrulamasının yanlış olduğunu; 404 ise URL’in hatalı yazıldığını gösterir. 403 ise genellikle IP kısıtlaması veya yetki eksikliğinden kaynaklanır. İlgili hata türlerinin derinlemesine çözümünü 403 forbidden hatası çözümü rehberinde bulabilirsiniz.

Webhook ile Dış Sistemlerden n8n’e Anlık Veri Alma

Bir API’ye istek göndermek işin yalnızca yarısıdır. Peki dış sistemden n8n’e veri nasıl anlık ulaşır? İşte burada Webhook düğümü devreye girer. Webhook, dış bir sistemde belirli bir olay gerçekleştiğinde n8n’e otomatik olarak HTTP isteği yollayan bir dinleyicidir.

Örneğin WooCommerce’de yeni bir sipariş oluştuğunda, n8n bu olayı anında öğrenmek için webhook kullanır. n8n’in ürettiği benzersiz URL’yi WooCommerce panelinde “Webhook” ayarına eklediğinizde, sistem her yeni siparişte bu URL’e veri gönderir. n8n de akışı anında tetikler.

Webhook Düğümünü Aktifleştirme

Webhook düğümünü kullanmak için şu adımları izleyin:

1. n8n’de yeni bir iş akışı oluşturun ve “Webhook” düğümünü ekleyin.
2. HTTP Method olarak POST seçin (çoğu servis POST ile veri gönderir).
3. “Test URL” seçeneğini aktif hale getirin.
4. n8n size bir URL verecektir. Bu URL’yi kopyalayın.
5. İlgili platformun Webhook ayarlarına bu URL’yi yapıştırın.
6. İlk test verisini göndererek akışı doğrulayın.

Webhook, özellikle anlık veri akışı gereken senaryolarda API’yi periyodik olarak sorgulamaktan çok daha verimlidir. Sürekli “acaba yeni sipariş var mı?” diye API’yi yoklamak yerine, sipariş olduğu anda size haber gelir. Bu hem sunucu kaynaklarını korur hem de gecikmeyi sıfıra indirir.

Webhook’ların çalışma prensibini daha detaylı öğrenmek isterseniz, daha önce yazdığımız Webhook Nedir, Nasıl Kullanılır? başlıklı rehbere göz atabilirsiniz.

API Kimlik Doğrulaması: Hangi Yöntemi Ne Zaman Kullanmalı?

API’lerin neredeyse tamamı, yetkisiz erişimi engellemek için kimlik doğrulama ister. n8n, bu süreci yönetmek için “Credentials” adı verilen bir bölüm sunar. API anahtarlarınızı burada saklarsınız; böylece her istekte tekrar tekrar şifre girmek zorunda kalmazsınız. Ayrıca bu veriler n8n’in veritabanında şifrelenmiş olarak tutulur.

En Yaygın API Kimlik Doğrulama Yöntemleri

n8n’de bu yöntemlerden herhangi birini “Generic Credential Type” başlığı altında seçebilirsiniz. Özellikle API Key ve Bearer Token yöntemleri, HTTP Request düğümünde en sık kullanılan iki seçenektir. OAuth 2.0 ise genellikle n8n’in hazır entegrasyon düğümleri üzerinden yönetilir.

API Anahtarını Credentials Bölümünde Saklama

API anahtarınızı doğrudan iş akışına yazmak büyük bir güvenlik riskidir. Akışı dışa aktardığınızda veya ekibinizle paylaştığınızda anahtar da görünür. Bunun yerine şu yolu izleyin:

1. Sol menüdeki Credentials bölümüne gidin.
2. “Add Credential” butonuna tıklayın.
3. “Generic Credential Type” > “Header Auth” seçin.
4. Name alanına X-API-Key, Value alanına ise anahtarınızı girin.
5. İş akışında HTTP Request düğümüne gelip Authentication alanından bu credential’ı seçin.

Bu yöntem, kimlik bilgilerinizi tek bir merkezde toplar ve olası sızıntıları büyük ölçüde engeller.

Gerçek Senaryo: CRM’den E-Ticaret Sistemine Müşteri Verisi Aktarma

Buraya kadar temel taşları konuştuk. Şimdi öğrendiklerimizi gerçek bir şirket senaryosuyla birleştirelim. Diyelim ki bir CRM yazılımı kullanıyorsunuz ve yeni eklenen müşterilerinizin e-posta adreslerini, e-ticaret sisteminizdeki bülten listesine otomatik aktarmak istiyorsunuz.

Bu senaryo, n8n API entegrasyonu için mükemmel bir örnek çünkü hem API’den veri çekmeyi hem de başka bir API’ye veri yazmayı içeriyor. Aynı zamanda hata yakalama ve veri dönüştürme adımlarını da kapsıyor.

Adım 1: CRM’den Müşteri Listesini Çekme

İlk olarak CRM’inizin REST API’sinden müşteri listesini çekin. Bunun için bir Schedule Trigger düğümü kullanarak akışı her 15 dakikada bir çalıştırabilirsiniz. Ardından HTTP Request düğümü ekleyip GET isteği gönderin.

GET /api/v1/contacts?updated_after=2026-01-01T00:00:00Z
Host: api.crm-ornegi.com
Authorization: Bearer GIZLI_TOKEN

Bu istek, belirtilen tarihten sonra güncellenen tüm kişileri size döndürür. Birden fazla sayfa varsa, döngü kurmayı unutmayın. Çoğu API, limit ve page parametreleriyle sayfalama yapar.

Adım 2: Veriyi Dönüştürme

CRM’den gelen veri ile e-ticaret sisteminin beklediği format genellikle birbirinden farklıdır. İşte bu noktada bir JavaScript düğümü devreye girer. Örneğin CRM’de full_name alanı varken, e-ticaret API’si first_name ve last_name bekliyor olabilir.

const input = $json;

const nameParts = input.full_name.split(' ');

return {
  first_name: nameParts[0] || '',
  last_name: nameParts.slice(1).join(' ') || '',
  email: input.email,
  tags: ['n8n-aktarim']
};

Bu küçük dönüşüm, iki sistem arasındaki format uyumsuzluğunu ortadan kaldırır. n8n’in asıl gücü de burada yatar: Sadece bağlantı kurmak değil, aynı zamanda veriyi anlamlı şekilde şekillendirmek.

Adım 3: E-Ticaret API’sine Müşteri Ekleme

Dönüştürülen veriyi e-ticaret sistemine göndermek için ikinci bir HTTP Request düğümü ekleyin. Method’u POST yapın, URL’i e-ticaret API’sinin müşteri oluşturma uç noktasına yönlendirin ve gövdeye JSON verisini ekleyin.

{
  "first_name": "Ahmet",
  "last_name": "Yılmaz",
  "email": "ahmet@sirket.com",
  "tags": ["n8n-aktarim"]
}

Bu isteğin sonucunda API 201 Created yanıtı dönerse, entegrasyon başarıyla çalışmış demektir. 400 Bad Request alırsanız, büyük olasılıkla alan adlarında bir hata vardır.

Bu tür e-ticaret otomasyonlarını daha da derinleştirmek isterseniz, WordPress hosting altyapınızı n8n ile aynı ağda konuşlandırmak veri gecikmesini minimuma indirir. Özellikle WooCommerce siteleri için yerel API bağlantıları daha hızlı çalışır.

Hata Yönetimi ve Yeniden Deneme Stratejileri

Kurduğunuz akış ilk gün sorunsuz çalışabilir. Peki ya API gece yarısı 500 hatası verirse? Ya da e-ticaret sistemi bakım nedeniyle 10 dakika yanıt vermezse? İşte bu tür durumlar için n8n’in hata yakalama mekanizmalarını kullanmak zorundasınız.

n8n’de bir düğüme bağlı Error Trigger kullanarak, normal akışta hata olduğunda devreye giren paralel bir akış kurabilirsiniz. Bu sayede hata sessizce kaybolmaz; size e-posta, Slack mesajı veya Telegram bildirimi gider.

Error Trigger ile Bildirim Kurma

1. Ana akışınızdaki HTTP Request düğümünün altına bir “Error Trigger” düğümü ekleyin.
2. Bu düğümün “Workflow” ayarında, izlenecek akışı seçin.
3. Error Trigger’ın çıktısını bir e-posta düğümüne bağlayın.
4. Hata mesajını ve hangi düğümde olduğunu e-postayla gönderin.

Bu yapı sayesinde, olumsuz senaryolardan anında haberdar olursunuz. Aynı zamanda iş akışındaki hata oranlarını azaltmak için yeniden deneme politikaları oluşturabilirsiniz.

Yeniden Deneme Mantığı Nasıl Kurulur?

n8n’in HTTP Request düğümünde doğrudan bir “retry” özelliği yoktur. Ancak IF düğümü ve Wait düğümünü kullanarak kendi yeniden deneme mekanizmanızı kurabilirsiniz. Basit bir mantık şöyledir:

• HTTP Request çıktısındaki statusCode değerini kontrol edin.
• 500 veya 502 gibi geçici hatalarda 1 dakika bekleyin.
• Ardından aynı isteği tekrar gönderin.
• Üst üste 3 başarısız denemeden sonra hata bildirimi tetikleyin.

Geçici sunucu hatalarını daha iyi anlamak için 502 bad gateway hatası rehberine bakabilirsiniz. Özellikle ağ geçidi sorunları, otomasyon akışlarını en çok kesintiye uğratan etkenlerdendir.

Şirket İçi n8n Hosting Altyapısı ve Performans Optimizasyonu

n8n’i nerede barındırdığınız, n8n API entegrasyonu performansınızı doğrudan etkiler. Kimi şirket n8n’i kendi bilgisayarında çalıştırır ama bu ciddi bir hatadır. Çünkü bilgisayar kapandığında otomasyonlarınız da durur. Kalıcı bir çözüm için 7/24 çalışan bir sunucu gerekir.

2026 itibarıyla n8n’i çalıştırmak için en popüler seçenekler; düşük maliyetli bir VDS, kurumsal bir Linux sunucu veya doğrudan n8n optimizasyonlu bir hosting hizmetidir. Hangi seçeneğin size uygun olduğunu anlamak için birkaç kritere bakalım.

n8n İçin Sunucu Gereksinimleri

n8n kendi başına çok fazla kaynak tüketmez. Ancak yoğun iş akışları, büyük veri dönüşümleri ve sık tetiklenen webhook’lar bellek kullanımını artırır. Önerilen minimum yapılandırma şudur:

• 2 vCPU (yoğun akışlarda 4 vCPU önerilir)
• 2 GB RAM (JavaScript düğümleri için 4 GB idealdir)
• 20 GB NVMe SSD disk
• Node.js 20+ (n8n’in güncel sürümleri için)

Eğer çok sayıda webhook dinliyorsanız ve veritabanı sorguları yoğunsa, NVMe SSD’li bir altyapı seçmek akış hızlarını belirgin şekilde artırır. NVMe’nin neden önemli olduğunu NVMe SSD vs SATA SSD karşılaştırmasında detaylandırmıştık.

n8n Kurulumunda Dikkat Edilmesi Gerekenler

Kurulum sırasında çoğu kişi yalnızca n8n’i başlatıp geçer. Ancak uzun vadeli verim için şu üç şeyi atlamamak gerekir:

1. PM2 ile süreç yönetimi: n8n süreci çökse bile otomatik yeniden başlasın.
2. Reverse proxy (Nginx): Webhook URL’lerinizi HTTPS üzerinden güvenle sunun.
3. Veritabanı yedekleme: İş akışlarınızın bulunduğu SQLite veya PostgreSQL veritabanını düzenli yedekleyin.

Özellikle Node.js tabanlı projeleri sunucuda yayınlama konusunu derinlemesine öğrenmek isterseniz, Express.js projelerini yayınlama rehberi sizin için faydalı olacaktır.

SaviorHost’un n8n & Node.js Hosting çözümleri, bu gereksinimleri varsayılan olarak karşılayacak şekilde yapılandırılmıştır. Böylece manuel kurulumla uğraşmadan doğrudan iş akışlarınıza odaklanabilirsiniz.

Sonuç: Otomasyon Yolculuğunuza Bugün Başlayın

n8n API entegrasyonu, şirketinizin tekrar eden veri aktarım işlerini ortadan kaldırmak için 2026’nın en güçlü araçlarından biri. Bu rehberde HTTP isteklerinin temellerinden webhook dinleyicilerine, kimlik doğrulamadan hata yönetimine kadar bütün kritik adımları ele aldık. Şimdi sıra sizde: Küçük bir iş akışı seçin, ilk düğümünüzü kurun ve sistemi iki hafta boyunca düzenli çalışır halde izleyin.

Unutmayın, iyi bir otomasyon altyapısı yalnızca yazılımdan değil; doğru sunucu, düzenli yedek ve güvenli kimlik yönetiminden oluşur. Eğer bu altyapıyı sıfırdan kurmakla uğraşmak istemiyorsanız, Linux hosting ya da n8n odaklı çözümlerle işe başlayabilirsiniz. Otomasyonun önündeki en büyük engel teknik bilgi değil, harekete geçmemektir.

Sıkça Sorulan Sorular

n8n API entegrasyonu yapmak için kod bilmek zorunlu mu?

Hayır, n8n’in hazır düğümleri sayesinde birçok popüler servisi kod yazmadan bağlayabilirsiniz. Ancak özel veri dönüşümleri için temel düzeyde JavaScript bilmek büyük avantaj sağlar. Yine de basit entegrasyonlar tamamen görsel arayüzle yapılabilir.

n8n API isteğinde 401 hatası neden oluşur?

401 Unauthorized hatası, API anahtarınızın yanlış veya eksik olduğu anlamına gelir. Headers bölümündeki anahtar adının tam doğru yazıldığından, credential’ın doğru seçildiğinden ve token’ın süresinin dolmadığından emin olun.

Webhook ile API arasındaki fark nedir?

API’de siz bir sunucuya istek gönderip veri çekersiniz. Webhook’ta ise olay gerçekleştiği anda dış sistem size otomatik olarak veri gönderir. Kısacası API’de siz sorarsınız, webhook’ta ise sistem size haber verir. n8n her ikisini de destekler.

n8n’i kendi sunucumda çalıştırmak veri güvenliği açısından faydalı mı?

Evet. Self-host edilen n8n, API anahtarlarınızın ve iş akışı verilerinizin kendi altyapınızda kalmasını sağlar. Bu, özellikle müşteri verilerini üçüncü taraf bir buluta göndermek istemeyen şirketler için kritik bir avantajdır. Verileriniz tamamen sizin kontrolünüzde olur.

n8n akışında hata olursa nasıl haberim olur?

n8n’de Error Trigger düğümü kullanarak hata anında tetiklenen ikincil bir akış kurabilirsiniz. Bu akış üzerinden e-posta, Slack veya Telegram bildirimleri gönderebilirsiniz. Böylece hatalar sessiz kalmaz ve hızlı müdahale edebilirsiniz.

n8n için hangi sunucu özellikleri yeterlidir?

Başlangıç için 2 vCPU, 2 GB RAM ve NVMe SSD disk yeterlidir. Ancak yoğun iş akışlarında 4 GB RAM önerilir. Sunucunun 7/24 açık kalması gerektiği için paylaşımlı hosting yerine VDS veya n8n optimizasyonlu bir hosting planı tercih edilmelidir.

n8n’de API yanıtı 500 hatası verirse ne yapmalıyım?

500 Internal Server Error, genellikle karşı sunucunun geçici bir sorunudur. Bu durumda yeniden deneme mekanizması kurmanız gerekir. IF düğümüyle hatayı yakalayıp 1 dakika bekledikten sonra aynı isteği tekrar gönderebilirsiniz. Üst üste başarısızlıklarda mutlaka bildirim gönderin.