n8n ile API Entegrasyonu Nasıl Yapılır?

İşletmeler ortalama 30 ila 100 arasında farklı SaaS uygulaması kullanıyor. Bu uygulamalar birbiriyle konuşmadığında, veriler silolara hapsolur. n8n, sunduğu güçlü API yetenekleriyle bu siloları yıkan en esnek araçlardan biridir.

Bu yazıda, n8n kullanarak temel bir API entegrasyonunun nasıl kurgulandığını inceleyeceğiz.

Webhook ile Veri Karşılama

Entegrasyonların çoğu bir "Tetikleyici" (Trigger) ile başlar. n8n'deki Webhook Node, uygulamanızın dış dünyadan veri kabul etmesini sağlayan bir kapıdır.

1. Webhook Node Ekleme: n8n canvas'ına bir Webhook node ekleyin.
2. Method Belirleme: Gelen veriyi yakalamak için genellikle POST metodu seçilir.
3. URL Kullanımı: n8n size test ve production için iki farklı URL verir. Test URL'i ile gelen veriyi anlık olarak görebilirsiniz.

HTTP Request Node ile Veri Gönderme

n8n, 400'den fazla hazır node sunsa da, her servisin hazır bir entegrasyonu olmayabilir. İşte bu noktada HTTP Request Node hayat kurtarır. Bu node, tıpkı Postman kullanır gibi, herhangi bir REST veya GraphQL API'ye istek atmanızı sağlar.

Authentication (Kimlik Doğrulama)

HTTP Request Node içerisinde kimlik doğrulama yöntemini seçebilirsiniz:

• Basic Auth
• Header Auth (örn. Authorization: Bearer <token>)
• OAuth2 (n8n'in credential yöneticisi ile token yenileme işlemleri otomatik halledilir).

Örnek Senaryo: Özel bir CRM'e Veri Gönderme

1. Webhook node ile web sitenizden gelen form verisini JSON formatında aldınız.
2. Set Node (veya Edit Fields Node) ile gelen veriyi CRM'in istediği formata dönüştürün.
3. HTTP Request Node üzerinden CRM'in /api/v1/contacts endpoint'ine bir POST isteği atın.
4. Body kısmına dönüştürdüğünüz veriyi bağlayın.

İleri Seviye: Pagination ve Error Handling

n8n'in asıl gücü, karmaşık senaryolardaki başarısıdır:

• Sayfalama (Pagination): Eğer bir API'den binlerce kayıt çekecekseniz, n8n'in HTTP Request node'unda yer alan otomatik sayfalama özelliğini kullanabilirsiniz.
• Hata Yönetimi (Error Handling): API cevap vermezse veya 500 hatası dönerse, n8n hata akışına (Error Trigger) geçebilir veya işlemi belirli aralıklarla tekrar deneyebilir (Retry).

API entegrasyonları, doğru yönetilmediğinde karmaşık kod yığınlarına dönüşebilir. n8n'in görsel arayüzü sayesinde bu süreçleri hem yazılımcılar hem de operasyon uzmanları kolaylıkla takip edebilir.