n8n-URL-Shortener: HTTP-Request-Node oder Elido-Community-Node

Um heute einen n8n-URL-Shortener auf Elido zu bauen, nutzen Sie n8ns eingebauten HTTP-Request-Node: POST an /v1/workspaces/{workspace_id}/links mit einem Bearer-Token, einer domain_id und einer destination_url, und die Antwort liefert den Slug des neuen Links sowie short_url zurück. Dieser Weg funktioniert sowohl auf n8n Cloud als auch selbst gehostet. Es gibt außerdem einen paketierten Community-Node, n8n-nodes-elido, der auf npm veröffentlicht ist (0.2.0) und dieselbe API in typisierten Feldern für selbst gehostete Instanzen einpackt.

Die meisten n8n-Short-Link-Suchen wollen diesen ersten Weg. Der HTTP-Request-Node braucht etwa fünf Minuten Einrichtung: ein Credential, zwei IDs aus deinem Workspace und einen JSON-Body. Danach ist er einfach ein weiterer Node.

Ich habe das aus der API und dem Paket-Quellcode geschrieben, nicht aus Marketingtexten, weil sich ein Request-Body exakt angeben lässt und mühsam zu erraten ist. Falls dir die REST-API selbst neu ist, deckt der Schnelleinstieg API und SDKs Tokens, Workspaces und den Rest der Oberfläche ab, auf der dieser Beitrag aufsetzt.

Zwei Wege, Links in n8n zu kürzen

n8n hat keinen eingebauten Shortener, es gibt also zwei Wege, Elido einzubinden:

• HTTP-Request-Node. In jeder n8n-Edition eingebaut, erreicht jeden Endpunkt und lässt dich Header wie Idempotency-Key selbst setzen. Das ist der Referenzweg.
• Community-Node n8n-nodes-elido. Ein paketierter Elido-Node mit einer Link-Ressource und vier Operationen (Create, Get, List, Get Analytics) plus einem Elido-API-Credential-Typ. Nur selbst gehostet.

Die Make- und IFTTT-Rezepte behandeln n8n als eine Option unter vier Plattformen. Hier bekommt n8n den ganzen Beitrag.

Eine URL mit dem HTTP-Request-Node kürzen

Beginne mit einem Token. Öffne in Elido Settings, dann API Tokens, und erstelle ein Personal Access Token; es beginnt mit elido_ und wird einmal angezeigt. Erstelle in n8n ein Header-Auth-Credential mit dem Namen Authorization und dem Wert Bearer elido_.... n8n verschlüsselt es at rest und hält es aus dem exportierten Workflow-JSON heraus, was besser ist, als den Header in jeden Node jedes Workflows einzufügen und sie dann alle an dem Tag zusammenzusuchen, an dem das Token rotiert. Geben Sie dem Token die Editor-Rolle und ein Ablaufdatum; unsere Übersicht zu API-Key-Berechtigungen für Link-Tools erklärt, warum ein Link-Workflow keine Adminrechte benötigt.

Als Nächstes zwei Zahlen. Deine Workspace-ID steht in der Dashboard-URL direkt nach /dashboard/. Für die Domain führe ein GET gegen /v1/workspaces/{workspace_id}/domains von einem Wegwerf-HTTP-Request-Node aus: Jeder Eintrag trägt eine id und einen hostname, und du brauchst beide.

Dann der Create-Aufruf selbst:

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"]
                }

Die Antwort ist der Link-Datensatz: id, slug, short_url, destination_url, domain_id, Tags und Zeitstempel. Übergeben Sie {{ $json.short_url }} an den nächsten Node; der notierte Hostname ist nur relevant, wenn Sie eine URL von Hand erstellen. Fügen Sie ein slug-Feld für eine individuelle hintere Hälfte hinzu (Starter-Plan und höher), oder lassen Sie es weg, und Elido generiert eines. n8ns HTTP-Request-Node-Doku deckt die übrigen Optionen ab, einschließlich eingebauter Paginierung für List-Aufrufe.

Der Elido-Community-Node für selbst gehostetes n8n

Der paketierte Node verkauft eine Sache: typisierte Felder. Er registriert ein Elido-API-Credential (Base URL, ein API-Token, das mit elido_ beginnt, und Workspace ID), und der Credential-Test liest GET /v1/workspaces/{id}. Dann gibt es einen Elido-Node mit einer Link-Ressource. Create nimmt eine Ziel-URL plus optionalen individuellen Slug, eine Domain-ID, Titel, Tags, Ablauf und einen Redirect-Status von 301, 302 oder 307. Get ruft einen einzelnen Link anhand seiner ID ab. List nimmt ein Limit von 1 bis 100 sowie Filter für Suche, Tags und aktiven oder deaktivierten Status und gibt einen n8n-Eintrag pro Link aus. Get Analytics nimmt eine Link-ID und einen Bericht (Klicks über die Zeit oder Klicks nach Land, Referrer, Gerät oder Browser), ein Von- und Bis-Datum mit dem Standard der letzten 30 Tage sowie ein Tages- oder Stundenintervall und gibt eine Zeile pro Eintrag aus. Link-Antworten enthalten short_url.

Eine Bedingung gilt, bevor Sie fest damit planen. n8n Cloud akzeptiert nur verifizierte Community-Nodes, und dieser ist nicht verifiziert, es geht also nur selbst gehostet oder gar nicht. Das Paket ist auf npm als Version 0.2.0 verfügbar:

npm view n8n-nodes-elido version

Auf einer selbst gehosteten Instanz kann ein Owner oder Admin Settings öffnen, dann Community Nodes, Install wählen und n8n-nodes-elido eingeben. Setzen Sie in Docker stattdessen N8N_COMMUNITY_PACKAGES="n8n-nodes-elido". Einen Elido-Trigger-Node gibt es noch nicht (einer ist geplant), Link-Ereignisse kommen also weiterhin über den n8n-Webhook-Node herein; außerdem sind Aktionen zum Aktualisieren und zum Nachschlagen per Slug geplant. Die Hilfeseite zum selbst gehosteten n8n enthält die Einrichtungsschritte. n8ns Leitfaden zur Installation von Community-Nodes deckt die GUI-, manuelle und Umgebungsvariablen-Wege ab, einschließlich des manuellen Wegs, den Queue-Mode-Setups brauchen.

Drei n8n-Short-Link-Workflows, die sich zu bauen lohnen

Das sind die Flows, die ich zuerst bauen würde, in aufsteigender Reihenfolge der Fummeligkeit. Jeder nutzt den obigen HTTP-Request-Aufruf plus Standard-n8n-Nodes, keiner hängt also vom Community-Paket ab.

RSS zu Short Link zu Slack. Ein RSS-Feed-Trigger fragt deinen Blog-Feed ab. Der HTTP-Request-Node postet {{ $json.link }} als Ziel und {{ $json.title }} als Titel. Ein Slack-Node postet dann den Hostnamen plus {{ $json.slug }} in deinen Ankündigungskanal. Das sind drei Nodes, null Dashboard-Besuche. Willst du UTM-Tags auf diesen Links, baue sie zuerst mit einem Set-Node ins Ziel ein; unser UTM-Tracking-Leitfaden hat die Namenskonvention.

Neue Sheet-Zeile zu Short Link und zurück. Ein Google-Sheets-Trigger feuert bei jeder neuen Zeile, der Create-Aufruf kürzt die Spalte url, und ein zweiter Sheets-Node schreibt die fertige Short URL zurück in dieselbe Zeile. Das ist eine handgestrickte Version von Bulk-Import aus Google Sheets, besser, wenn Zeilen täglich eintröpfeln, und schlechter, wenn du 5.000 auf einmal einfügst.

Neuer Link an einen Audit-Kanal. Setze n8ns Webhook-Node an den Anfang und abonniere seine Produktions-URL für link.created unter Settings, Webhooks in Elido. Schalte die Raw-Body-Option des Webhook-Nodes ein, denn die Signatur ist ein HMAC-SHA256 über timestamp.raw_body, und ein neu serialisierter JSON-Body passt nicht dazu. Verifiziere in einem Code-Node, poste dann Slug und Ziel an Slack. Das Webhook-Formular im Dashboard listet Link-Lifecycle- und Workspace-Ereignisse auf, keine per Klick (ein click.created-Ereignis ist geplant), für Klick-Reports würde ich also stattdessen einen geplanten Pull laufen lassen. Der Beitrag zu Webhook-Ereignissen behandelt Retries und Header.

Genug davon, jeden Montag Links von Hand in dieselben drei Tools einzufügen? Öffne einen kostenlosen Workspace, präge ein Token und verdrahte den obigen RSS-Flow in etwa der Zeit, die du zum Lesen dieses Abschnitts brauchst.

Fehlerbehandlung: Retries, Duplikate und fehlgeschlagene Läufe

n8n gibt jedem Node zwei Einstellungen, die hier zählen. Retry On Fail wiederholt den Node bei einem Fehler, mit einer von dir gewählten Wartezeit, und On Error entscheidet, ob der Workflow stoppt, weitermacht oder den Fehler über einen separaten Error-Output leitet. Für ein workflow-weites Netz zeigt n8ns Leitfaden zum geordneten Fehlerhandling, wie man jeden Workflow auf einen einzigen Error-Workflow zeigen lässt, der mit einem Error-Trigger beginnt.

Passe die Einstellung an den Statuscode an. Ein 429 oder ein beliebiges 5xx lohnt sich mit ein paar Sekunden Wartezeit erneut zu versuchen, da die API bei Rate Limits Retry-After setzt und der Free-Tarif 60 Anfragen pro Minute erlaubt. Ein 400 wird von selbst nicht besser und ist meist eine fehlende domain_id oder destination_url. Ein 409 beim Erstellen bedeutet, dass der individuelle Slug schon vergeben ist, leite ihn also über den Error-Output statt dieselbe Anfrage fünfmal zu wiederholen und hänge ein Suffix an.

Hier ist der Teil, den ich mir gewünscht hätte, dass mir jemand vorher sagt. Ohne Idempotency-Key wird ein Create-Aufruf, der nach dem Timeout wiederholt wird, obwohl der Server den Link bereits geschrieben hat, zu einem Duplikat. Deshalb sendet das obige Beispiel eines, das aus der Execution-ID und dem Item-Index gebaut ist: Ein Retry desselben Items spielt die ursprüngliche Antwort erneut ab, statt einen zweiten Link zu prägen. Der Leitfaden zu Rate Limits und Idempotenz erklärt das Replay-Fenster.

Community-Node vs. HTTP Request: Was wählen

Der paketierte Node und der HTTP-Request-Node erreichen dieselbe API, das ist also eher eine Wartungsfrage als eine Frage der Fähigkeiten.

Meine Faustregel: Bauen Sie standardmäßig auf HTTP Request, weil es auf jeder n8n-Edition läuft und Sie jeden Header kontrollieren, und greifen Sie auf einer selbst gehosteten Instanz zum Community-Node, wenn jemand, der kein JSON liest, den Workflow übernimmt und seine vier Operationen die Aufgabe abdecken. Für die vollständige Endpunktliste siehe die API-und-SDKs-Feature-Seite, und wenn ein Push-Modell besser passt als Polling, decken Elido-Webhooks die ausgehende Seite ab. Wägen Sie stattdessen gehostete Tools ab? Lesen Sie auch den Zapier-Leitfaden.

Lies den Cornerstone → URL-Shortener-API-und-SDKs-Schnelleinstieg

Verwandtes im Blog

• Short-Link-Automatisierung mit Make und IFTTT - dieselben Aufgaben auf zwei gehosteten Automatisierungsplattformen.
• Zapier-URL-Shortener-Automatisierung - native Zapier-App, kein Self-Hosting.
• Webhooks für Link-Ereignisse - Payloads, Signaturen und Retry-Verhalten.
• API-Rate-Limits und Idempotenz - Retries ohne doppelte Links.
• Slack-Link-Shortening-Bot und Alerts - wann die Slack-Seite eine eigene App verdient.
• Selbst gehostete Link-Automatisierung mit n8n - Docker, Reverse Proxy und signierte Webhooks auf deinem eigenen Server.