Scurtător de URL n8n: HTTP Request sau nod comunitar

Ca să construiești astăzi un scurtător de URL pe n8n cu Elido, folosește nodul HTTP Request încorporat al n8n: POST către /v1/workspaces/{workspace_id}/links cu un token Bearer, un domain_id și un destination_url, iar răspunsul îți întoarce slug-ul noului link și short_url. Ruta aceasta funcționează la fel pe n8n Cloud și pe instanțe găzduite de tine. Există și un nod de comunitate împachetat, n8n-nodes-elido, publicat pe npm (0.2.0), care învelește același API în câmpuri tipizate pentru instanțele găzduite de tine.

Majoritatea căutărilor pentru un link scurt în n8n vor prima rută. Nodul HTTP Request cere cam cinci minute de configurare: o credențială, două ID-uri din workspace-ul tău și un corp JSON. După aceea este doar încă un nod.

Am scris-o pornind de la API și de la codul sursă al pachetului, nu de la text de marketing, pentru că un corp de cerere este ușor de enunțat exact și dureros de ghicit. Dacă API-ul REST în sine îți este nou, quickstart-ul pentru API și SDK-uri acoperă tokenurile, workspace-urile și restul suprafeței pe care stă acest articol.

Două moduri de a scurta linkuri în n8n

n8n nu are un scurtător încorporat, deci există două moduri de a conecta Elido:

• Nodul HTTP Request. Încorporat în orice ediție n8n, ajunge la fiecare endpoint și îți lasă să setezi singur antete precum Idempotency-Key. Este calea de referință.
• Nodul de comunitate n8n-nodes-elido. Un nod Elido împachetat, cu o resursă Link și patru operații (Create, Get, List, Get Analytics), plus un tip de credențială Elido API. Doar pe instanțe găzduite de tine.

Rețetele Make și IFTTT tratează n8n ca o opțiune între patru platforme. Aici n8n primește tot articolul.

Scurtarea unui URL cu nodul HTTP Request

Începe cu un token. În Elido, deschide Setări, apoi API Tokens, și creează un token personal de acces; începe cu elido_ și se afișează o singură dată. În n8n, creează o credențială Header Auth cu numele Authorization și valoarea Bearer elido_.... n8n o criptează în repaus și o ține în afara JSON-ului exportat al fluxului, ceea ce bate lipirea antetului în fiecare nod al fiecărui flux și apoi vânarea tuturor în ziua în care se rotește tokenul. Dă tokenului rolul de editor și o dată de expirare; analiza noastră despre permisiunile cheilor API pentru uneltele de linkuri explică de ce un flux de linkuri nu are nevoie niciodată de admin.

Apoi, două numere. ID-ul workspace-ului tău se află în URL-ul dashboardului, imediat după /dashboard/. Pentru domeniu, rulează un GET către /v1/workspaces/{workspace_id}/domains dintr-un nod HTTP Request de unică folosință: fiecare element are un id și un hostname, iar ai nevoie de amândouă.

Apoi apelul de creare propriu-zis:

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

Răspunsul este înregistrarea linkului: id, slug, short_url, destination_url, domain_id, taguri și timestampuri. Mapează {{ $json.short_url }} în nodul următor; hostname-ul pe care l-ai notat contează doar dacă construiești un URL manual. Adaugă un câmp slug pentru un final personalizat (planurile Pro și Business) sau omite-l și Elido generează unul. Documentația nodului HTTP Request din n8n acoperă celelalte opțiuni, inclusiv paginarea încorporată pentru apelurile de listare.

Nodul de comunitate Elido pentru n8n găzduit de tine

Nodul împachetat vinde un singur lucru: câmpuri tipizate. Înregistrează o credențială Elido API (Base URL, un API Token care este o cheie API de workspace ce începe cu elido_ și Workspace ID), iar testul credențialei citește GET /v1/workspaces/{id}. Apoi există un singur nod Elido cu o resursă Link. Create primește un URL de destinație plus, opțional, un slug personalizat, un ID de domeniu, un titlu, taguri, o expirare și un status de redirecționare 301, 302 sau 307. Get preia un link după ID. List primește o limită de la 1 la 100 și filtre pentru căutare, taguri și stare activă sau dezactivată și emite un element n8n per link. Get Analytics primește un ID de link și un raport (clicuri în timp sau clicuri pe țară, referrer, dispozitiv sau browser), o dată From și To care implicit acoperă ultimele 30 de zile și un interval de zi sau de oră, cu un element per rând. Răspunsurile de link includ short_url.

O condiție se aplică înainte să planifici în jurul lui. n8n Cloud acceptă doar noduri de comunitate verificate, iar acesta nu este verificat, deci ori găzduit de tine, ori deloc. Pachetul în sine este pe npm ca versiunea 0.2.0:

npm view n8n-nodes-elido version

Pe o instanță găzduită de tine, un proprietar sau un admin poate deschide Setări, apoi Community Nodes, poate selecta Install și poate introduce n8n-nodes-elido. În Docker, setează în schimb N8N_COMMUNITY_PACKAGES="n8n-nodes-elido". Nu există încă un nod declanșator Elido (unul este planificat), așa că evenimentele de link intră în continuare prin nodul Webhook al n8n, iar acțiunile Update și Look Up după slug sunt de asemenea planificate. Pagina de ajutor pentru n8n găzduit de tine are pașii de configurare. Ghidul n8n de instalare a nodurilor de comunitate acoperă variantele prin interfață, manuală și prin variabile de mediu, inclusiv cea manuală de care au nevoie configurațiile în modul coadă.

Trei fluxuri n8n de linkuri scurte care merită construite

Acestea sunt fluxurile pe care le-aș construi primele, în ordinea crescătoare a migalei. Fiecare folosește apelul HTTP Request de mai sus plus noduri n8n standard, deci niciunul nu depinde de pachetul de comunitate.

RSS către link scurt către Slack. Un RSS Feed Trigger interoghează feed-ul blogului tău. Nodul HTTP Request postează {{ $json.link }} ca destinație și {{ $json.title }} ca titlu. Un nod Slack postează apoi hostname-ul plus {{ $json.slug }} în canalul tău de anunțuri. Sunt trei noduri, zero vizite în dashboard. Dacă vrei taguri UTM pe acele linkuri, construiește-le în destinație cu un nod Set mai întâi; ghidul nostru de urmărire UTM are convenția de denumire.

Rând nou din foaie către link scurt și înapoi. Un declanșator Google Sheets se activează la fiecare rând nou, apelul de creare scurtează coloana url, iar un al doilea nod Sheets scrie URL-ul scurt gata făcut înapoi în același rând. Este o versiune făcută de mână a importului în masă din Google Sheets, mai bună când rândurile sosesc picătură cu picătură zilnic și mai slabă când lipești 5.000 deodată.

Link nou către un canal de audit. Pune primul nodul Webhook al n8n și abonează URL-ul lui de producție la link.created în Setări, Webhooks din Elido. Activează opțiunea Raw Body a nodului Webhook, pentru că semnătura este un HMAC-SHA256 peste timestamp.raw_body, iar un corp JSON reserializat nu se va potrivi. Verifică într-un nod Code, apoi postează slug-ul și destinația în Slack. Formularul de webhook din dashboard listează evenimente din ciclul de viață al linkurilor și al workspace-ului, nu evenimente per click (un eveniment click.created este planificat), așa că pentru rapoartele de click aș rula în schimb o extragere programată. Articolul despre evenimentele webhook acoperă reîncercările și antetele.

Te-ai săturat să lipești linkuri de mână în aceleași trei unelte în fiecare luni? Deschide un workspace gratuit, creează un token și conectează fluxul RSS de mai sus în aproximativ timpul cât citești această secțiune.

Tratarea erorilor: reîncercări, duplicate și rulări eșuate

n8n oferă fiecărui nod două setări care contează aici. Retry On Fail reia nodul la eroare, cu o așteptare pe care o alegi, iar On Error decide dacă fluxul se oprește, continuă sau dirijează eșecul pe o ieșire de eroare separată. Pentru o plasă la nivel de flux, ghidul n8n despre tratarea elegantă a erorilor arată cum îndrepți fiecare flux către un singur flux de erori care pornește cu un Error Trigger.

Potrivește setarea cu codul de status. Un 429 sau orice 5xx merită reîncercat cu o așteptare de câteva secunde, deoarece API-ul setează Retry-After la limitele de rată, iar planul Free permite 10 cereri pe secundă per workspace (burst de 20). Un 400 nu se va îndrepta singur și este de obicei un domain_id sau destination_url lipsă. Un 409 la creare înseamnă că slug-ul personalizat este luat, așa că dirijează-l pe ieșirea de eroare și adaugă un sufix, în loc să reîncerci aceeași cerere de cinci ori.

Iată partea pe care mi-aș fi dorit s-o aud de la cineva. Fără un Idempotency-Key, un apel de creare care depășește timpul după ce serverul a scris deja linkul este reîncercat într-un duplicat. De aceea exemplul de mai sus trimite unul construit din ID-ul execuției și indexul elementului: o reîncercare a aceluiași element reia răspunsul original în loc să creeze un al doilea link. Ghidul despre limite de rată și idempotență explică fereastra de reluare.

Nodul de comunitate vs HTTP Request: pe care îl folosești

Nodul împachetat și nodul HTTP Request ajung la același API, deci aceasta este mai degrabă o alegere de întreținere decât una de capabilități.

Regula mea de bază: construiește implicit pe HTTP Request, pentru că rulează pe orice ediție n8n și controlezi fiecare antet, și alege nodul de comunitate pe o instanță găzduită de tine când fluxul va fi deținut de cineva care nu citește JSON și când cele patru operații ale lui acoperă treaba. Pentru lista completă de endpointuri, vezi pagina funcționalității API și SDK-uri, iar dacă un model push se potrivește mai bine decât interogarea periodică, webhook-urile Elido acoperă partea de ieșire. Cântărești în schimb unelte găzduite? Citește și ghidul Zapier.

Citește articolul de referință → Quickstart pentru API-ul și SDK-urile scurtătorului de URL

Articole conexe

• Automatizarea linkurilor scurte cu Make și IFTTT - aceleași sarcini pe două platforme de automatizare găzduite.
• Automatizarea scurtătorului de URL cu Zapier - aplicație Zapier nativă, fără găzduire proprie.
• Webhook-uri pentru evenimentele linkurilor - payload-uri, semnături și comportamentul reîncercărilor.
• Limite de rată API și idempotență - reîncercare fără linkuri duplicate.
• Bot Slack pentru scurtarea linkurilor și alerte - când partea de Slack merită propria aplicație.
• Automatizarea linkurilor cu n8n găzduit de tine - Docker, reverse proxy și webhook-uri semnate pe propriul server.