n8n URL Kısaltıcı: HTTP Request veya Topluluk Düğümü

Bugün Elido üzerinde bir n8n URL kısaltıcı kurmak için n8n'in yerleşik HTTP Request düğümünü kullanın: Bearer belirteci, bir domain_id ve bir destination_url ile /v1/workspaces/{workspace_id}/links adresine POST gönderin; yanıt yeni bağlantının slug'ını ve short_url değerini verir. Bu yol n8n Cloud'da da kendi sunucunuzda da çalışır. Ayrıca npm'de yayımlanmış (0.2.0) paketlenmiş bir topluluk düğümü, n8n-nodes-elido, aynı API'yi kendi sunucunuzda barındırılan örnekler için türlendirilmiş alanlarla sarıyor.

n8n kısa bağlantı aramalarının çoğu ilk yolu istiyor. HTTP Request düğümü yaklaşık beş dakikalık kurulum ister: bir kimlik bilgisi, çalışma alanınızdan iki kimlik ve bir JSON gövdesi. Sonrasında sıradan bir düğümden farkı kalmaz.

Bunu pazarlama metninden değil, API ve paket kaynağından yazdım; çünkü bir istek gövdesini tam olarak söylemek kolay, tahmin etmek ise acı verici. REST API'si sizin için yeniyse API ve SDK hızlı başlangıcı belirteçleri, çalışma alanlarını ve bu yazının dayandığı yüzeyin geri kalanını anlatıyor.

n8n'de Bağlantıları Kısaltmanın İki Yolu

n8n'de yerleşik kısaltıcı yok; bu yüzden Elido'yu bağlamanın iki yolu var:

• HTTP Request düğümü. Her n8n sürümüne yerleşik, her uç noktaya ulaşır ve Idempotency-Key gibi başlıkları kendiniz ayarlamanıza izin verir. Referans yol bu.
• n8n-nodes-elido topluluk düğümü. Bir Link kaynağı ve dört işlemi (Create, Get, List, Get Analytics) ile bir Elido API kimlik bilgisi türü olan paketlenmiş bir Elido düğümü. Yalnızca kendi sunucunuzda.

Make ve IFTTT tarifleri n8n'i dört platformdan biri olarak ele alıyor. Burada tüm yazı n8n'e ait.

HTTP Request Düğümüyle Bir URL'yi Kısaltmak

Bir belirteçle başlayın. Elido'da Settings, sonra API Tokens bölümünü açın ve kişisel bir erişim belirteci oluşturun; elido_ ile başlar ve yalnızca bir kez gösterilir. n8n'de adı Authorization, değeri Bearer elido_... olan bir Header Auth kimlik bilgisi oluşturun. n8n bunu bekleme halinde şifreler ve dışa aktarılan iş akışı JSON'undan uzak tutar; bu, başlığı her iş akışının her düğümüne yapıştırıp belirteç yenilendiği gün hepsini tek tek aramaktan iyidir. Belirtece editör rolü ve bir son kullanma tarihi verin; bağlantı araçları için API anahtarı izinleri dökümümüz, bir bağlantı iş akışının neden yöneticiye hiç ihtiyaç duymadığını anlatıyor.

Sonra iki sayı. Çalışma alanı kimliğiniz pano URL'sinde /dashboard/'dan hemen sonra duruyor. Alan adı için tek seferlik bir HTTP Request düğümünden /v1/workspaces/{workspace_id}/domains adresine bir GET çalıştırın: her öğe bir id ve bir hostname taşır ve ikisine de ihtiyacınız var.

Sonra oluşturma çağrısının kendisi:

Method:         POST
URL:            https://api.elido.app/v1/workspaces/1/links
Authentication: Generic credential > Header Auth (Authorization: Bearer elido_...)
Headers:        Idempotency-Key: {{ $execution.id }}-{{ $itemIndex }}
Body (JSON):    {
                  "domain_id": 7,
                  "destination_url": "{{ $json.link }}",
                  "title": "{{ $json.title }}",
                  "tags": ["n8n", "rss"]
                }

Yanıt bağlantı kaydıdır: id, slug, short_url, destination_url, domain_id, etiketler ve zaman damgaları. {{ $json.short_url }} değerini sonraki düğüme eşleyin; not ettiğiniz ana makine adı yalnızca URL'yi elle kuracaksanız önem taşır. Özel bir son kısım için bir slug alanı ekleyin (Pro ve Business planları) ya da boş bırakın, Elido bir tane üretsin. n8n'in HTTP Request düğümü belgeleri liste çağrıları için yerleşik sayfalama dahil kalan seçenekleri kapsar.

Kendi Sunucunuzdaki n8n İçin Elido Topluluk Düğümü

Paketlenmiş düğüm tek bir şey satıyor: türlendirilmiş alanlar. Bir Elido API kimlik bilgisi kaydeder (Base URL, elido_ ile başlayan bir çalışma alanı API anahtarı olan API Token ve çalışma alanı kimliği) ve kimlik bilgisi testi GET /v1/workspaces/{id} okur. Ardından Link kaynağı olan tek bir Elido düğümü var. Create, bir hedef URL ile isteğe bağlı özel slug, alan adı kimliği, başlık, etiketler, son kullanma ve 301, 302 ya da 307 yönlendirme durumu alır. Get, bir bağlantıyı kimliğiyle getirir. List, 1 ile 100 arası bir sınır ve arama, etiketler ile etkin veya devre dışı durumu için filtreler alır ve bağlantı başına bir n8n öğesi yayar. Get Analytics bir bağlantı kimliği ile bir rapor (zaman içinde tıklamalar ya da ülkeye, yönlendiren kaynağa, cihaza veya tarayıcıya göre tıklamalar), varsayılanı son 30 gün olan From ve To tarihi ve gün ya da saat aralığı alır; her satır için bir öğe verir. Bağlantı yanıtları short_url içerir.

Etrafında plan yapmadan önce bir koşul var. n8n Cloud yalnızca doğrulanmış topluluk düğümlerini kabul eder ve bu doğrulanmış değil; yani ya kendi sunucunuzda barındırırsınız ya da hiç. Paketin kendisi npm'de 0.2.0 sürümüyle duruyor:

npm view n8n-nodes-elido version

Kendi sunucunuzda barındırılan bir örnekte sahip ya da yönetici Settings, sonra Community Nodes'u açabilir, Install'u seçip n8n-nodes-elido yazabilir. Docker'da bunun yerine N8N_COMMUNITY_PACKAGES="n8n-nodes-elido" ayarlayın. Henüz bir Elido tetikleyici düğümü yok (biri planlanıyor); bu yüzden bağlantı olayları hâlâ n8n'in Webhook düğümünden gelir, Update ve slug ile Look Up eylemleri de planlanıyor. Kendi sunucunuzda n8n yardım sayfasında kurulum adımları var. n8n'in topluluk düğümü kurulum rehberi arayüz, elle ve ortam değişkeni yollarını, kuyruk modu kurulumlarının ihtiyaç duyduğu elle yolu da içerek kapsıyor.

Kurmaya Değer Üç n8n Kısa Bağlantı İş Akışı

İlk olarak kuracağım akışlar bunlar, uğraştırıcılığı artan sırayla. Her biri yukarıdaki HTTP Request çağrısını ve hazır n8n düğümlerini kullanır; yani hiçbiri topluluk paketine bağlı değil.

RSS'ten kısa bağlantıya, oradan Slack'e. Bir RSS Feed Trigger blog akışınızı yoklar. HTTP Request düğümü {{ $json.link }} değerini hedef, {{ $json.title }} değerini başlık olarak gönderir. Ardından bir Slack düğümü ana makine adını ve {{ $json.slug }} değerini duyurular kanalınıza gönderir. Üç düğüm, sıfır pano ziyareti. O bağlantılara UTM etiketleri istiyorsanız önce bir Set düğümüyle bunları hedefe ekleyin; UTM takip rehberimizde adlandırma düzeni var.

Yeni sayfa satırından kısa bağlantıya ve geri. Bir Google Sheets tetikleyicisi her yeni satırda çalışır, oluşturma çağrısı url sütununu kısaltır ve ikinci bir Sheets düğümü bitmiş kısa URL'yi aynı satıra geri yazar. Google Sheets'ten toplu içe aktarmanın elle yapılmış hali; satırlar günlük damla damla geldiğinde daha iyi, 5.000 tanesini birden yapıştırdığınızda daha kötü.

Yeni bağlantıdan bir denetim kanalına. n8n'in Webhook düğümünü başa koyun ve üretim URL'sini Elido'da Settings, Webhooks altında link.created olayına abone edin. Webhook düğümünün Raw Body seçeneğini açın, çünkü imza timestamp.raw_body üzerinde bir HMAC-SHA256'dır ve yeniden serileştirilmiş bir JSON gövdesi eşleşmez. Bir Code düğümünde doğrulayın, sonra slug'ı ve hedefi Slack'e gönderin. Panonun webhook formu bağlantı yaşam döngüsü ve çalışma alanı olaylarını listeler, tıklama başına olanları değil (bir click.created olayı planlanıyor); bu yüzden tıklama raporları için zamanlanmış bir çekme çalıştırırdım. Webhook olayları yazısı yeniden denemeleri ve başlıkları kapsıyor.

Her pazartesi aynı üç araca bağlantıları elle yapıştırmaktan bıktınız mı? Ücretsiz bir çalışma alanı açın, bir belirteç üretin ve yukarıdaki RSS akışını bu bölümü okuyacağınız sürede bağlayın.

Hata Yönetimi: Yeniden Denemeler, Kopyalar ve Başarısız Çalıştırmalar

n8n her düğüme burada önem taşıyan iki ayar verir. Retry On Fail, hata olunca düğümü seçtiğiniz bir beklemeyle yeniden çalıştırır; On Error ise iş akışının durup durmayacağına, devam edip etmeyeceğine ya da hatayı ayrı bir hata çıkışından yönlendirip yönlendirmeyeceğine karar verir. İş akışı genelinde bir ağ için n8n'in hataları zarifçe yönetme rehberi, her iş akışını bir Error Trigger ile başlayan tek bir hata iş akışına nasıl yönelteceğinizi gösteriyor.

Ayarı durum koduna göre eşleyin. 429 ya da herhangi bir 5xx birkaç saniyelik beklemeyle yeniden denemeye değer, çünkü API hız sınırlarında Retry-After ayarlar ve Free plan çalışma alanı başına saniyede 10 isteğe izin verir (patlama 20). Bir 400 kendiliğinden düzelmez ve genellikle eksik bir domain_id ya da destination_url'dir. Oluşturmada 409, özel slug'ın alınmış olduğu anlamına gelir; bu yüzden aynı isteği beş kez yeniden denemek yerine onu hata çıkışından yönlendirin ve bir sonek ekleyin.

Birinin bana söylemesini isteyeceğim kısım şu. Idempotency-Key olmadan, sunucu bağlantıyı yazdıktan sonra zaman aşımına uğrayan bir oluşturma çağrısı yeniden denenip bir kopyaya dönüşür. Yukarıdaki örneğin yürütme kimliğinden ve öğe dizininden kurulu bir anahtar göndermesinin nedeni bu: aynı öğenin yeniden denemesi ikinci bir bağlantı üretmek yerine özgün yanıtı yeniden döndürür. Hız sınırları ve idempotency rehberi yeniden yanıt penceresini açıklıyor.

Topluluk Düğümü mü, HTTP Request mi: Hangisi

Paketlenmiş düğüm ve HTTP Request düğümü aynı API'ye ulaşır; bu yüzden bu bir yetenekten çok bakım tercihidir.

Pratik kuralım: varsayılan olarak HTTP Request üzerine kurun, çünkü her n8n sürümünde çalışır ve her başlığı siz denetlersiniz; topluluk düğümüne ise kendi sunucunuzdaki bir örnekte, iş akışının sahibi JSON okumayan biri olacaksa ve dört işlemi işi karşılıyorsa başvurun. Tam uç nokta listesi için API ve SDK özellik sayfasına bakın; yoklamadan çok itme modeli size uyuyorsa Elido webhook'ları giden tarafı kapsar. Bunun yerine barındırılan araçları mı tartıyorsunuz? Zapier anlatımını da okuyun.

Köşe taşı yazıyı okuyun → URL kısaltıcı API ve SDK hızlı başlangıcı

Blogdaki İlgili Yazılar

• Make ve IFTTT ile kısa bağlantı otomasyonu - aynı işler, iki barındırılan otomasyon platformunda.
• Zapier URL kısaltıcı otomasyonu - yerel Zapier uygulaması, kendi sunucu gerekmez.
• Bağlantı olayları için webhook'lar - yükler, imzalar ve yeniden deneme davranışı.
• API hız sınırları ve idempotency - kopya bağlantı olmadan yeniden deneme.
• Slack bağlantı kısaltma botu ve uyarıları - Slack tarafı kendi uygulamasını hak ettiğinde.
• n8n ile kendi sunucunuzda bağlantı otomasyonu - kendi sunucunuzda Docker, ters vekil ve imzalı webhook'lar.