n8n URL-verkorter: HTTP Request of community-node

Om vandaag een n8n URL-verkorter op Elido te bouwen, gebruik je de ingebouwde HTTP Request-node van n8n: POST naar /v1/workspaces/{workspace_id}/links met een Bearer-token, een domain_id en een destination_url, en het antwoord geeft de slug en short_url van de nieuwe link terug. Die route werkt op n8n Cloud en zelf gehost. Er is ook een verpakte community-node, n8n-nodes-elido, gepubliceerd op npm (0.2.0), die dezelfde API in getypeerde velden verpakt voor zelf gehoste instanties.

De meeste zoekopdrachten naar een n8n-korte-link willen die eerste route. De HTTP Request-node vraagt ongeveer vijf minuten setup: één credential, twee ID's uit je werkruimte en een JSON-body. Daarna is het gewoon nog een node.

Ik heb dit geschreven vanuit de API en de broncode van het pakket in plaats van vanuit marketingtekst, omdat een request-body makkelijk exact te noemen is en pijnlijk om te raden. Is de REST API zelf nieuw voor je, dan behandelt de quickstart voor API en SDK's tokens, werkruimtes en de rest van het oppervlak waarop dit artikel steunt.

Twee manieren om links te verkorten in n8n

n8n heeft geen verkorter ingebouwd, dus er zijn twee manieren om Elido te koppelen:

• HTTP Request-node. Ingebouwd in elke n8n-editie, bereikt elk endpoint en laat je headers zoals Idempotency-Key zelf instellen. Het is het referentiepad.
• Community-node n8n-nodes-elido. Een verpakte Elido-node met een Link-resource en vier bewerkingen (Create, Get, List, Get Analytics) plus een credentialtype voor de Elido API. Alleen zelf gehost.

De recepten voor Make en IFTTT behandelen n8n als één optie uit vier platforms. Hier krijgt n8n het hele artikel.

Een URL verkorten met de HTTP Request-node

Begin met een token. Open in Elido Instellingen, daarna API-tokens, en maak een persoonlijk toegangstoken aan; het begint met elido_ en wordt maar één keer getoond. Maak in n8n een Header Auth-credential met de naam Authorization en de waarde Bearer elido_.... n8n versleutelt het in rust en houdt het buiten de geëxporteerde workflow-JSON, wat beter is dan de header in elke node van elke workflow plakken en ze allemaal opsporen op de dag dat het token roteert. Geef het token de rol editor en een vervaldatum; onze uitleg over API-sleutelrechten voor linktools legt uit waarom een linkworkflow nooit admin nodig heeft.

Daarna twee getallen. Je werkruimte-ID staat in de dashboard-URL direct na /dashboard/. Voor het domein voer je met een wegwerp-HTTP Request-node één GET uit naar /v1/workspaces/{workspace_id}/domains: elk item heeft een id en een hostname, en je hebt beide nodig.

Dan de create-aanroep zelf:

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

Het antwoord is het linkrecord: id, slug, short_url, destination_url, domain_id, tags en tijdstempels. Wijs {{ $json.short_url }} toe aan de volgende node; de hostnaam die je noteerde doet er alleen toe als je met de hand een URL bouwt. Voeg een slug-veld toe voor een eigen staartje (plannen Pro en Business), of laat het weg en Elido genereert er een. De documentatie van de HTTP Request-node van n8n behandelt de overige opties, inclusief ingebouwde paginering voor lijstaanroepen.

De Elido-community-node voor zelf gehoste n8n

De verpakte node verkoopt één ding: getypeerde velden. Hij registreert een credential voor de Elido API (Base URL, een API Token dat een API-sleutel van de werkruimte is die met elido_ begint, en de ID van de werkruimte), en de credentialtest leest GET /v1/workspaces/{id}. Daarna is er één Elido-node met een Link-resource. Create neemt een bestemmings-URL plus optioneel een eigen slug, domein-ID, titel, tags, verloop en een redirectstatus 301, 302 of 307. Get haalt één link op via ID. List neemt een limiet van 1 tot 100 en filters voor zoeken, tags en actieve of uitgeschakelde status, en geeft één n8n-item per link. Get Analytics neemt een link-ID en een rapport (klikken in de tijd, of klikken per land, referrer, apparaat of browser), een From- en To-datum die standaard de laatste 30 dagen is, en een interval per dag of uur, met één item per rij. Linkantwoorden bevatten short_url.

Eén voorwaarde geldt voordat je erop bouwt. n8n Cloud accepteert alleen geverifieerde community-nodes, en deze is niet geverifieerd, dus het is zelf hosten of niets. Het pakket zelf staat op npm als versie 0.2.0:

npm view n8n-nodes-elido version

Op een zelf gehoste instantie kan een eigenaar of admin Instellingen, daarna Community Nodes openen, Install kiezen en n8n-nodes-elido invoeren. In Docker stel je in plaats daarvan N8N_COMMUNITY_PACKAGES="n8n-nodes-elido" in. Er is nog geen Elido-triggernode (er staat er een gepland), dus linkgebeurtenissen komen nog binnen via de Webhook-node van n8n, en acties voor Update en Look Up by slug staan ook gepland. De helppagina over zelf gehoste n8n heeft de setupstappen. De installatiegids voor community-nodes van n8n behandelt de routes via de GUI, handmatig en met omgevingsvariabelen, inclusief de handmatige route die setups in wachtrijmodus nodig hebben.

Drie n8n-workflows voor korte links die het bouwen waard zijn

Dit zijn de flows die ik het eerst zou bouwen, in oplopende volgorde van gepriegel. Elke gebruikt de HTTP Request-aanroep van hierboven plus standaard n8n-nodes, dus geen enkele hangt af van het community-pakket.

RSS naar korte link naar Slack. Een RSS Feed Trigger pollt je blogfeed. De HTTP Request-node post {{ $json.link }} als bestemming en {{ $json.title }} als titel. Een Slack-node post daarna de hostnaam plus {{ $json.slug }} in je aankondigingskanaal. Dat zijn drie nodes, nul bezoeken aan het dashboard. Wil je UTM-tags op die links, bouw ze dan eerst met een Set-node in de bestemming; onze gids over UTM-tracking heeft de naamgevingsconventie.

Nieuwe sheetrij naar korte link en terug. Een Google Sheets-trigger vuurt bij elke nieuwe rij, de create-aanroep verkort de kolom url en een tweede Sheets-node schrijft de klare korte URL terug in dezelfde rij. Het is een zelfgebouwde versie van bulkimport uit Google Sheets, beter als rijen dagelijks binnendruppelen en slechter als je er 5.000 tegelijk plakt.

Nieuwe link naar een auditkanaal. Zet de Webhook-node van n8n eerst en abonneer zijn productie-URL op link.created onder Instellingen, Webhooks in Elido. Zet de optie Raw Body van de Webhook-node aan, omdat de handtekening een HMAC-SHA256 is over timestamp.raw_body en een opnieuw geserialiseerde JSON-body niet overeenkomt. Verifieer in een Code-node en post dan de slug en bestemming naar Slack. Het webhookformulier in het dashboard toont levenscyclus- en werkruimtegebeurtenissen van links, geen gebeurtenissen per klik (een click.created-gebeurtenis staat gepland), dus voor klikrapporten zou ik een geplande pull draaien. Het artikel over webhookgebeurtenissen behandelt herhaalpogingen en headers.

Moe van elke maandag handmatig links plakken in dezelfde drie tools? Open een gratis werkruimte, maak een token aan en koppel de RSS-flow hierboven in ongeveer de tijd die je nodig hebt om deze sectie te lezen.

Foutafhandeling: herhaalpogingen, duplicaten en mislukte runs

n8n geeft elke node twee instellingen die hier tellen. Retry On Fail draait de node opnieuw bij een fout, met een wachttijd naar keuze, en On Error bepaalt of de workflow stopt, doorgaat of de fout via een aparte foutuitgang laat lopen. Voor een vangnet over de hele workflow laat de gids van n8n over fouten netjes afhandelen zien hoe je elke workflow naar één foutworkflow wijst die begint met een Error Trigger.

Stem de instelling af op de statuscode. Een 429 of elke 5xx is het waard om opnieuw te proberen met een wachttijd van een paar seconden, want de API zet Retry-After bij ratelimieten en het Free-plan staat 10 verzoeken per seconde per werkruimte toe (burst 20). Een 400 wordt niet vanzelf beter, en het is meestal een ontbrekende domain_id of destination_url. Een 409 bij aanmaken betekent dat de eigen slug bezet is, dus laat hem via de foutuitgang lopen en voeg een achtervoegsel toe in plaats van hetzelfde verzoek vijf keer te herhalen.

Dit is het deel dat ik zelf graag gehoord had. Zonder Idempotency-Key wordt een create-aanroep die in een time-out loopt nadat de server de link al heeft weggeschreven, opnieuw geprobeerd tot een duplicaat. Daarom stuurt het voorbeeld hierboven er een mee, opgebouwd uit het uitvoerings-ID en de itemindex: een herhaalpoging voor hetzelfde item speelt het oorspronkelijke antwoord opnieuw af in plaats van een tweede link te maken. De gids over ratelimieten en idempotentie legt het afspeelvenster uit.

Community-node versus HTTP Request: wat gebruik je

De verpakte node en de HTTP Request-node bereiken dezelfde API, dus dit is meer een onderhoudskeuze dan een kwestie van mogelijkheden.

Mijn vuistregel: bouw standaard op HTTP Request, omdat die in elke n8n-editie draait en je elke header beheert, en grijp op een zelf gehoste instantie naar de community-node als iemand die geen JSON leest de workflow gaat beheren en de vier bewerkingen de klus dekken. Voor de volledige endpointlijst zie de featurepagina over API en SDK's, en past een pushmodel beter dan polling, dan dekken de webhooks van Elido de uitgaande kant. Overweeg je liever gehoste tools? Lees dan ook de Zapier-walkthrough.

Lees de cornerstone → Quickstart voor de URL-verkorter-API en SDK's

Gerelateerd op de blog

• Automatisering van korte links met Make en IFTTT - dezelfde klussen op twee gehoste automatiseringsplatforms.
• Zapier URL-verkorter-automatisering - native Zapier-app, geen zelf hosten.
• Webhooks voor linkgebeurtenissen - payloads, handtekeningen en herhaalgedrag.
• Ratelimieten en idempotentie van de API - opnieuw proberen zonder dubbele links.
• Slack-bot voor het verkorten van links en meldingen - als de Slack-kant een eigen app verdient.
• Zelf gehoste linkautomatisering met n8n - Docker, reverse proxy en ondertekende webhooks op je eigen server.