n8n, görsel bir arayüzle API'leri birbirine bağlamanıza olanak tanıyan güçlü bir no-code otomasyon aracıdır. Ancak entegrasyon sırasında kimlik doğrulama, hata yönetimi ve veri dönüşümü gibi konularda takılmalar yaşanabilir. Bu yazıda, n8n ile API entegrasyonlarınızı sorunsuz hale getirecek pratik ipuçlarını ve kontrol listesini bulacaksınız.
1. Kimlik Doğrulama ve Yetkilendirme
API entegrasyonunda en sık karşılaşılan sorun kimlik doğrulamadır. n8n, OAuth2, API anahtarı ve Basic Auth gibi yöntemleri destekler. Dikkat edilmesi gereken noktalar:
- API anahtarınızı n8n'in güvenlik ayarlarına ekleyin: Kullanıcı adı veya başlık alanına anahtarı yerleştirirken, çoğu API anahtarını
Authorization: Bearer {token}formatında ister. n8n'in "Header Authentication" türünü kullanarak bu başlığı manuel ekleyin. - OAuth2 yenileme token'ları: Eğer OAuth2 kullanıyorsanız, n8n'in "OAuth2" kimlik doğrulama türünü seçip yenileme token'ını otomatik almasına izin verin. REST API'lerde JWT ile Güvenli Kimlik Doğrulama yazımızda JWT'nin nasıl yönetileceğini anlattık; n8n'de de aynı mantık geçerlidir.
- Özel başlıklar ve sorgu parametreleri: Bazı API'ler ekstra başlık veya sorgu parametresi ister. n8n'in HTTP Request düğümünde "Options" sekmesinden ekleyin.
2. Hata Yönetimi ve Yeniden Deneme Stratejileri
API çağrıları zaman zaman başarısız olabilir. n8n ile esnek bir hata yönetimi kurmak için:
- Hata çıkışlarını kullanın: Her düğümde "Error" çıkışını aktif edin ve bir hata işleme düğümüne bağlayın. Bu sayede hata durumunda loglama, bildirim veya alternatif akış tetikleyebilirsiniz.
- Yeniden deneme sayısını ayarlayın: HTTP Request düğümünün "Settings" kısmında "Retry on Fail" seçeneğini 2-3 kez olarak ayarlayın. Ancak idempotent olmayan işlemlerde (örneğin ödeme) yeniden denemeyi dikkatli kullanın.
- Zaman aşımı süresini artırın: Yavaş API'ler için "Timeout" değerini 30 saniyeye çıkarın. n8n varsayılanı 30 saniyedir; bu yeterli olmazsa artırın.
Detaylı hata yönetimi ipuçları için Express.js REST API'lerinde Merkezi Hata Yönetimi yazımıza göz atabilirsiniz; benzer prensipler n8n'de de geçerlidir.
3. Veri Dönüşümü ve Haritalama
API'ler arası veri aktarırken alan adları, veri tipleri ve formatlar uyuşmayabilir. n8n'de dönüşüm için:
- Set düğümü kullanın: Veriyi yeniden yapılandırmak için "Set" düğümünü ekleyin. Bu düğüm sayesinde alanları yeniden adlandırabilir, sabit değerler ekleyebilir veya hesaplama yapabilirsiniz.
- Function düğümü ile karmaşık dönüşümler: JavaScript bilginiz varsa "Function" düğümüyle gelişmiş dönüşümler yazın. Örneğin, tarih formatını değiştirme veya dizileri birleştirme.
- JSON'i düzleştirme: İç içe JSON yapılarını düzleştirmek için "Flatten" düğümünü kullanın veya Function ile parse edin.
4. Performans ve Sınırlamalar
n8n'in kendi çalıştırma süresi sınırları vardır. Uzun süren işlemlerde şunlara dikkat edin:
- Veri boyutunu sınırlayın: Bir API'den büyük miktarda veri çekiyorsanız, sayfalama yapın. n8n'in "Loop Over Items" özelliğiyle sayfaları döngüye alabilirsiniz.
- Eşzamanlılık ayarları: n8n'in ayarlarından maksimum eşzamanlı iş sayısını artırabilirsiniz. Self-hosted kurulumda kaynakları buna göre planlayın.
- Önbellekleme: Sık kullanılan API yanıtlarını önbelleğe almak için "Cache" düğümünü kullanın (varsa) veya harici bir veritabanına yazın.
5. Güvenlik ve En İyi Uygulamalar
API anahtarları ve hassas verilerin güvenliği için:
- Kimlik bilgilerini n8n'in içinde saklayın: Kullanıcı adı/şifre veya API anahtarlarını doğrudan iş akışına gömmeyin. n8n'in "Credentials" bölümünü kullanın.
- HTTPS kullanın: Tüm API uç noktalarının HTTPS üzerinden erişilebilir olduğundan emin olun.
- Minimal izin prensibi: API anahtarlarınıza yalnızca gerekli izinleri verin; gereksiz kapsamlar risk oluşturur.
Kontrol Listesi (Checklist)
Projeye başlamadan önce aşağıdaki maddeleri tamamlayın:
- ☐ API dökümantasyonu okundu ve gerekli kimlik doğrulama yöntemi belirlendi.
- ☐ n8n'de credentials (kimlik bilgileri) oluşturuldu ve test edildi.
- ☐ HTTP Request düğümü ile temel bir çağrı yapıldı ve yanıt doğrulandı.
- ☐ Hata çıkışları ve yeniden deneme ayarları eklendi.
- ☐ Veri dönüşüm düğümleri (Set veya Function) eklendi ve test edildi.
- ☐ Sayfalama için döngü yapısı oluşturuldu (eğer büyük veri varsa).
- ☐ Zaman aşımı eşikleri ve yeniden deneme sayısı ayarlandı.
- ☐ Hassas veriler (API anahtarı, token) credentials içinde saklanıyor.
- ☐ İş akışı bir kere başarıyla çalıştırıldı ve sonuç doğrulandı.
Bu ipuçları ve kontrol listesiyle n8n entegrasyonlarınızda karşılaştığınız sorunları minimize edebilir, iş akışlarınızı daha güvenilir hale getirebilirsiniz. Hangi otomasyon platformunun sizin için uygun olduğunu merak ediyorsanız Zapier vs Make (Integromat) karşılaştırmamıza göz atın.
Sık Sorulan Sorular
n8n'de API çağrısı için hangi kimlik doğrulama türünü kullanmalıyım?
API'ye göre değişir: çoğu modern API 'Bearer Token' veya 'API Key' başlık olarak ister. n8n'de 'Header Authentication' veya 'OAuth2' seçeneklerinden uygun olanı kullanın.
n8n'de hata durumunda iş akışı nasıl durdurulmaz?
Hata çıkışını başka bir düğüme bağlayarak veya iş akışı ayarlarından 'Continue on Fail' seçeneğini etkinleştirerek iş akışının devam etmesini sağlayabilirsiniz.
n8n'de sayfalama nasıl yapılır?
HTTP Request düğümünü döngüye alın. Yanıttan sayfa bilgisini çekip bir sonraki isteğe parametre olarak ekleyin. 'Loop Over Items' özelliğiyle her sayfayı işleyebilirsiniz.