n8n'de HTTP Request Nasıl Kullanılır?

n8n'de HTTP Request node'u, REST API'si olan herhangi bir uygulamaya ya da hizmete istek gönderip veri almayı sağlar. Workflow, n8n'de bir işi otomatik yapan adımların bütünüdür. Node ise workflow'un adımlarından biridir. n8n editörü, workflow'ların kurulup düzenlendiği ekrandır. Editörün ortasındaki canvas, node'ların eklenip birbirine bağlandığı çalışma alanıdır ve her node burada bir kutu olarak görünür. API, bir yazılımın başka bir yazılıma istek gönderip cevap alabildiği arayüzdür. REST API, bir hizmetin verisine ve işlemlerine web adresleri üzerinden erişilmesini sağlayan yaygın bir API türüdür. HTTP ise web adreslerine istek gönderip cevap almak için kullanılan kurallar bütünüdür.

n8n'de HTTP Request node'u ne işe yarar?

n8n belgelerine göre HTTP Request node'u, n8n'in en esnek node'larından biridir. Belgelere göre bir hizmetin hazır n8n node'u istenen işlemi desteklemiyorsa HTTP Request node'u da kullanılabilir. AI Agent node'u, hangi adımı atacağına bir dil modelinin karar verdiği node'dur. Araç (tool), AI Agent'ın bir işi yapmak için kullanabildiği node'dur. HTTP Request node'u, AI Agent node'una araç olarak da bağlanabilir.

Örnek: Bir kişi, hava durumu verisi sunan bir hizmetin API'sine her sabah GET isteği gönderen bir workflow kurar. Workflow, gelen sıcaklık bilgisini kişiye bir Telegram mesajıyla iletir.

Temel n8n kavramları n8n nedir yazısında anlatılır.

n8n'de HTTP isteği nasıl kurulur?

Curl, bilgisayarda yazılı komutlarla HTTP isteği göndermeye yarayan bir araçtır. Uç nokta (endpoint), API'nin istek kabul ettiği web adresidir.

n8n belgelerine göre istek iki yolla kurulur: node'un parametreleri doldurularak ya da hizmetin API belgesindeki bir curl komutu içe aktarılarak. Parametrelerle kurulum şu adımlarla yapılır:

1. Canvas'taki bir node'un sağındaki "Add node" (+) düğmesine tıkla. n8n, node'ları arayıp seçebildiğin node panelini (nodes panel) açar.
2. Arama kutusuna "HTTP Request" yaz ve HTTP Request node'unu seç. n8n node'u canvas'a ekler ve ayar penceresini açar. Pencerede Parameters sekmesi açık gelir.
3. Method alanında isteğin yöntemini seç, örneğin veri almak için GET.
4. URL alanına hizmetin API belgesindeki uç noktayı yaz.
5. Hizmet kimlik doğrulama istiyorsa Authentication alanında bir tür seç.
6. Hizmetin API belgesine bak. Hizmet sorgu parametresi, başlık ya da gövde istiyorsa Send Query Parameters, Send Headers ya da Send Body seçeneğini aç.
7. Bir seçeneği açtıysan açılan alanlara API belgesindeki değerleri gir.
8. Node'daki "Execute step" düğmesine tıkla ve hizmetten gelen cevabı node'un çıktısında kontrol et.

Belgelere göre Method alanında DELETE, GET, HEAD, OPTIONS, PATCH, POST ve PUT yöntemleri vardır. GET veri alır, POST veri gönderir, PUT ve PATCH veriyi günceller, DELETE veriyi siler. İstekle gönderilebilecek bilgiler şunlardır:

JSON, verinin ad ve değer çiftleriyle yazıldığı yaygın bir biçimdir. Belgelere göre API belgesinde curl örneği varsa istek şu adımlarla içe aktarılır:

1. HTTP Request node'unun Parameters sekmesinde "Import cURL" düğmesine tıkla. Import cURL command penceresi açılır.
2. Curl komutunu metin kutusuna yapıştır.
3. "Import" düğmesine tıkla. n8n isteğin ayarlarını node'un alanlarına yükler.

Örnek: Bir kişi, hava durumu hizmetinin API belgesindeki curl komutunu "Import cURL" ile HTTP Request node'una aktarır. n8n, URL ve Method alanlarını doldurur. Kişi node'u çalıştırır ve sıcaklık bilgisini node'un çıktısında görür.

HTTP Request'te kimlik doğrulama nasıl yapılır?

Credential, n8n'in bir hizmete bağlanmak için gereken giriş bilgisini sakladığı kayıttır. HTTP Request node'unda credential, Authentication alanında ayarlanır. n8n belgelerine göre iki tür credential kullanılabilir:

n8n belgeleri, hizmet için hazır bir credential türü varsa Predefined Credential Type seçeneğini önerir, çünkü kurulumu ve yönetimi daha kolaydır. Bu seçenek şu adımlarla kullanılır:

1. Authentication alanında Predefined Credential Type'ı seç.
2. Credential Type alanında kullanmak istediğin hizmetin API'sini seç.
3. Var olan bir credential'ı seç.
4. Credential yoksa "Create New" ile yeni bir credential oluştur. Açılan pencere, hizmetin API anahtarını ya da hesap bilgisini ister.

API anahtarı, bir hizmetin kullanıcıya verdiği ve isteği kimin gönderdiğini gösteren gizli koddur. Generic Credential Type'ta belgelere göre şu türler vardır:

Erişim jetonu (token), hizmetin verdiği ve giriş izni sağlayan uzun bir koddur. Belgelere göre Custom auth'a benzeyen Simplified Custom Auth türü n8n 2.35.0 sürümünden itibaren seçilebilir. Bu türde gizli değerler Auth template alanındaki JSON'a yazılmaz. JSON'da gizli değerlerin yerinde, değerin sonradan geleceğini gösteren işaretler (yer tutucu) bulunur. Gerçek değerler credential penceresindeki ayrı alanlara girilir.

Örnek: Bir hizmet, isteklerde Authorization başlığında "Bearer" kelimesi ve bir erişim jetonu bekler. Kullanıcı Generic Credential Type altında Bearer auth'u seçer ve hizmetin verdiği jetonu credential'a yazar.

HTTP Request'te çok sayfalı sonuçlar nasıl alınır?

Pagination (sayfalama), büyük bir veri kümesinin birden çok sayfaya bölünmesidir. Belgelere göre API'nin tek istekte döndüremeyeceği kadar büyük sonuçlar için Options bölümündeki Pagination seçeneği kullanılır. Pagination Mode alanında üç seçenek vardır:

Expression, bir alanın değerini önceki node'ların verisinden ya da gelen cevaptan dolduran yazımdır. Belgelere göre Pagination seçeneğini kurmadan önce API belgesine bakmak ya da tek bir istekle dönen veriyi incelemek gerekir.

Örnek: Bir API, ürün listesini sayfalara bölerek döndürür ve her cevapta sonraki sayfanın adresini verir. Kullanıcı Pagination Mode olarak Response Contains Next URL'yi seçer ve Next URL alanına bu adresi gösteren bir expression yazar. Böylece n8n, node bir kez çalıştığında bütün sayfaları çeker.

Örnek: Başka bir API, sayfa numarasını bir sorgu parametresiyle ister. Kullanıcı Update a Parameter in Each Request'i seçer ve parametrenin değerini her istekte bir sonraki sayfa numarası olacak biçimde ayarlar. Böylece n8n bütün sayfaları çeker.

n8n HTTP Request'te hangi hatalar çıkar?

n8n belgelerine göre sık görülen hatalar ve çözümleri şunlardır:

• "Bad request" (400) hatası çoğunlukla geçersiz bir sorgu parametresi adından ya da değerinden çıkar. Bir parametreye birden çok değer (dizi) gönderiyorsan Options bölümündeki Array Format in Query Parameters seçeneğini dene.
• "The resource you are requesting could not be found" hatası, URL alanındaki adresin geçersiz olduğunu gösterir. Nedeni URL'deki bir yazım hatası ya da artık kullanılmayan bir API olabilir. URL'yi API belgesindeki adresle karşılaştır.
• "Forbidden" (403) hatası, kimlik doğrulamanın başarısız olduğunu gösterir. API anahtarının izinlerini güncelle ya da gerekli izinlere sahip yeni bir anahtar oluştur.
• 429 hatası, hizmetin çok fazla istek aldığını gösterir. Options bölümündeki Batching seçeneği istekleri gruplara böler ve aralarına bekleme koyar. Node'un Settings sekmesindeki Retry on Fail ayarı da isteği yeniden dener.
• "Connection refused" (ECONNREFUSED) hatası, hedef adreste dinleyen bir program olmadığını gösterir. Docker, programları konteyner denen yalıtılmış ortamlarda çalıştıran bir araçtır. localhost, bir programın içinde çalıştığı makinenin kendi adresidir. Docker'da çalışan n8n'de bu adres konteynerin kendisini gösterir. Mac ya da Windows'taki Docker Desktop'ta, bilgisayardaki bir hizmete ulaşmak için localhost yerine host.docker.internal adresi kullanılır.
• n8n Cloud'da bu hatanın nedeni farklıdır. n8n Cloud, n8n şirketinin işlettiği sunucularda çalışan ve tarayıcıdan kullanılan sürümdür. Burada workflow'lar kullanıcının bilgisayarındaki bir hizmete ulaşamaz. Tünel, bilgisayardaki bir hizmeti internetten erişilebilir kılan araçtır. Belgeler bu durumda yerel hizmetin bir tünelle internete açılmasını ve HTTP Request node'unda tünelin verdiği adresin kullanılmasını önerir.

Sonraki adım

n8n'de yeni bir workflow aç ve bir HTTP Request node'u ekle. Kullandığın bir hizmetin API belgesinden bir curl örneği kopyala ve "Import cURL" ile node'a aktar. Node'u çalıştır ve gelen cevabı node'un çıktısında incele.