Sari la conținut
LinkdashLinkdash
Română
Esc
↑↓navighează↵deschide⌘Jprevizualizează
Pe această pagină

CLI

Instalează linkdash-cli din npm, apoi rulează comanda `linkdash`. Comenzile reușite afișează JSON pe stdout. Ajutorul și erorile sunt text simplu pe stderr.

npm i -g linkdash-cli
# or: pnpm add -g linkdash-cli / bun add -g linkdash-cli / npx linkdash-cli@latest

Pachetul npm este linkdash-cli. Comanda este linkdash.

Echivalentul HTTP: API HTTP. MCP: MCP. Skill pentru agenți: Skill pentru agenți. Prețuri: Prețuri. Markdown simplu: cli.md.

Nu există flag-ul --json. Codul de ieșire este 1 la erori.

Autentificare

linkdash auth create
linkdash auth login
linkdash auth whoami
linkdash auth logout

Nu ai încă un cont? auth create deschide https://linkdash.dev/sign-up, apoi revine la https://linkdash.dev/device cu codul CLI, ca să poți aproba. Ai deja un cont? auth login deschide /device. Headless: setează LINKDASH_TOKEN la un token de sesiune obținut din auth create sau auth login. Nu inventa tokenuri.

Fișierul de sesiune: ~/.config/linkdash/config.json (mod 0600).

CLI-ul nu poate schimba emailul, parola sau facturarea. Trimite utilizatorul la dashboard. Chei API (HTTP și MCP): Chei API.

Comenzi

linkdash <command> [options]
Comandă Ce face
auth create Înregistrare în browser, apoi aprobarea dispozitivului
auth login Autentificare în browser prin dispozitiv
auth logout Uită sesiunea salvată
auth whoami JSON-ul contului autentificat
links list Listează linkurile și folderele, câte o pagină odată (--limit, --cursor)
links get <id> Un singur link
links create --url <url> Link scurt dintr-un URL
links create --file <path> Încarcă un fișier și primești un link
links create --text <text> Salvează un snippet
links create --folder <name> Creează un folder
links create --variant <name> … Link cu mai multe variante (split / targetare)
links update <id> Schimbă destinația, fișierul, parola, expirarea, domeniul, statusul, sticky sau parametrii transmiși mai departe
links move <id> --in <folder-id> Pune un link sau un folder într-un folder (--root pentru nivelul de sus)
links copy <id> Creează o copie cu un slug nou, în același folder
links delete <id> Șterge un link (elementele unui folder urcă un nivel; --with-contents le șterge)
links share <id> --email <email> Partajează cu persoane prin email (repetă --email; --role editor le permite să-l modifice; fiecare persoană nouă primește un email de invitație)
links unshare <id> --email <email> Elimină accesul cuiva
links shares [id] Cine îl poate deschide în afară de tine, inclusiv printr-un folder de deasupra. Fără id: tot ce ai partajat prin invitații, câte o pagină odată (--limit, --cursor)
links shared Ce au partajat alții cu tine, câte o pagină odată (--limit, --cursor)
links leave <_id | share URL> Renunță la ceva partajat cu tine
links role <id> --email <e> --role viewer|editor Fă pe cineva pe care l-ai invitat viewer sau editor
links unlock <_id | share URL> Introdu parola unui element partajat ca să-i vezi și să-i editezi ținta timp de 30 de minute
links activity <id> Cine a modificat un element și cum
links reset-link <id> URL de partajare nou; vechiul URL linkdash.dev/s/ nu mai funcționează
links stats <id> Totalurile de vizite, descărcări și redări, inclusiv pe variante, plus crawlerele
links export Afișează toate linkurile ca CSV (un rând per variantă)
links import <file> Importă rânduri cu URL-uri și text din CSV
links variants list <id> Variantele unui link
links variants add <id> --name <n> Adaugă o variantă
links variants update <id> <name> Modifică o variantă
links variants remove <id> <name> Elimină o variantă
webhooks list Listează endpointurile webhook (cu secretul mascat)
webhooks get <id> Afișează URL-ul unui webhook (cu secretul mascat)
webhooks create --url <https> Adaugă un endpoint HTTPS (secretul e afișat o singură dată)
webhooks rotate <id> Emite un nou secret de semnare
webhooks delete <id> Elimină un webhook
domains list Listează hostname-urile personalizate
domains add <host> Adaugă un hostname (1 pe Free)
domains connect <host> URL-ul de aplicare Domain Connect, sau null
domains verify <host> Verifică DNS-ul cu Unkey
domains remove <host> Elimină un hostname
-h, --help Ajutor (text simplu)
-v, --version Versiune

Dacă același slug există pe două domenii ale proprietarului, transmite --domain.

Flaguri pentru create și update

Slug-ul este id-ul linkului și calea lui publică atunci când linkul e public. Numele e vizibil doar pentru tine. Linkurile noi sunt restricționate (vezi Acces și partajare). Create acceptă exact una dintre variantele: --url, --file sau --text (aceasta devine varianta main), blocuri --variant (vezi Variante) sau --folder <name> (vezi Foldere).

Flag Note
--url <url> URL-ul destinație
--file <path> Fișierul de încărcat (la create, sau înlocuiește conținutul la update)
--text <text> Snippet
--access <restricted|link|public> Cine îl poate deschide. Implicit restricted. Vezi Acces și partajare
--reset-share-link Emite un nou URL de partajare (doar la update)
--slug <id> Calea publică: a-z0-9 și cratime interne, 1–64
--name <label> Etichetă privată
--tag <tag> Repetabil. Litere mici, fără virgule. Maximum 20
--starts <when> Devine activ după 7d, 24h, 30m sau la o dată ISO
--password <secret> Cere această parolă la deschidere
--expires <when> Nu mai e servit după 7d, 24h, 30m sau după o dată ISO
--max-openings <n> Se pune pe pauză după atâtea deschideri. Omite-l pentru nelimitat
--domain <host> Servește pe acest host în loc de lida.sh
--in <folder-id> Creează în acest folder (doar la create; --in-domain <host> dacă slug-ul folderului se repetă)
--status <active|paused> Pune pe pauză sau reia (doar la update)
--sticky / --no-sticky Vizitatorul care revine păstrează aceeași variantă (implicit sticky)
--restart-split Reamestecă atribuirile sticky (doar la update)
--forward-params / --no-forward-params Adaugă query string-ul vizitatorului la variantele URL (implicit dezactivat). Vezi Transmiterea parametrilor de query
--variant <name> Începe un bloc de variantă (doar la create). Vezi Variante
--weight <n> --when <key=v1,v2> Per variantă. Vezi Variante și Reguli pentru parametrii de query
--preview-name <text> Numele public din unfurl
--preview-description <text> Descrierea publică din unfurl
--preview-image <path> Imaginea publică din unfurl
--utm-source --utm-medium --utm-campaign --utm-term --utm-content Doar pentru linkuri URL
--clear-password --clear-expires --clear-starts --clear-tags --clear-preview --clear-name --clear-max-openings Doar la update

--status acceptă doar active sau paused. Statusul expirat vine din --expires. Statusul programat vine din --starts. Rezolvarea publică întoarce not-found până la start. După ce se atinge --max-openings, linkul se pune pe pauză; mărește numărul sau folosește --clear-max-openings ca să fie servit din nou. Deschiderile deja folosite rămân numărate până când schimbi sau elimini limita.

Slug-urile lida.sh sunt comune pentru toți utilizatorii. Dacă un cuvânt e deja luat, adaugă un domeniu personalizat și încearcă din nou cu --domain. Un link pe un domeniu de brand nu se publică și pe lida.sh.

Flaguri pentru list

Afișează o pagină, {items, cursor}: --limit este 1-100 (implicit 50); transmite --cursor cu valoarea cursor din pagina anterioară până când aceasta devine null. O pagină poate conține mai puține elemente decât --limit când un filtru exclude unele. --q caută cuvinte întregi, ultimul fiind tratat ca prefix (laun găsește example.com/launch), cu rezultatele ordonate după relevanță; --in listează un singur folder, cu folderele primele; altfel, cele mai noi apar primele.

Flag Note
--limit <n> Elemente per pagină, 1-100 (implicit 50)
--cursor <c> cursor-ul din pagina anterioară
--q <text> Caută cuvinte în nume, slug, numele și țintele variantelor, numele fișierelor, textul snippeturilor și taguri
--tag <tag> Filtrează după tag
--kind <url|file|text|folder|group> Filtrează după tip (group = mai multe variante)
--status <status> active, paused, expired, scheduled sau mixed
--in <folder-id|root> Doar ce se află direct în acest folder sau la nivelul de sus. Fără el, se listează tot

Variante

Fiecare link este un container cu una sau mai multe variante. O variantă înseamnă conținutul (URL, fișier sau text) plus propriile restricții de acces (--password, --starts, --expires, --max-openings), un --weight și condiții opționale pentru vizitatori (--when). Fără --variant, un link are o singură variantă numită main, iar fiecare comandă de mai sus e o prescurtare pentru ea. Un vizitator primește o singură variantă: variantele al căror --when se potrivește formează pool-ul (dacă niciuna nu se potrivește, îl formează variantele fără condiții), apoi urmează o alegere ponderată. Cu atribuirea sticky (implicită), un vizitator care revine păstrează aceeași variantă. Restricțiile linkului au prioritate față de cele ale variantelor. Numele variantelor: litere mici, cifre, cratime interne, 1–40 de caractere, unice per link. Maximum 20 de variante.

kind-ul linkului este tipul variantei când există o singură variantă și group când sunt mai multe. status-ul linkului este cel dat de restricția linkului când aceasta e setată (paused, scheduled, expired), altfel statusul comun al variantelor, altfel mixed. variantStatuses numără {active, paused, expired, scheduled}.

Creare cu blocuri de variante

linkdash links create --slug promo --variant a --url https://example.com/a --variant b --url https://example.com/b --weight 3
linkdash links create --slug hi --variant de --url https://example.de --when country=DE,AT --variant rest --url https://example.com

--variant <name> începe un bloc de variantă. Flagurile de după el aparțin acelei variante până la următorul --variant: --url|--file|--text, --password, --starts, --expires, --max-openings, --weight <n>, --when <key=v1,v2> (repetabil), --utm-*. Flagurile linkului (--slug --name --tag --domain --preview-* --password --starts --expires --max-openings --sticky --no-sticky --forward-params) se pun înainte de primul --variant.

Subcomenzi pentru variante

linkdash links variants list promo
linkdash links variants add promo --name mobile --url https://m.example.com --when device=mobile
linkdash links variants update promo mobile --when country=DE,AT --when device=mobile --weight 2
linkdash links variants update promo b --status paused
linkdash links variants remove promo b

variants add <id> --name <n> acceptă una dintre opțiunile --url, --file, --text, plus flagurile de restricție, --weight, --when, --utm-*. variants update <id> <name> acceptă --name <new>, conținut, flagurile de restricție, --status active|paused, --weight, --when, --clear-when, --clear-password, --clear-starts, --clear-expires, --clear-max-openings. Un link păstrează cel puțin o variantă.

Cheile --when

Cheie Câmp JSON Valori
country countries Coduri ISO-2 (DE, AT)
device devices mobile tablet desktop
os os windows macos android ios linux other
browser browsers edge chrome firefox safari other
language languages potrivire după prefix (de, en-us)
referrer referrerHosts sufix de host (twitter.com)

Fiecare cheie setată trebuie să se potrivească. --when country=DE,AT --when device=mobile înseamnă { "countries": ["DE","AT"], "devices": ["mobile"] }.

Reguli pentru parametrii de query

--when acceptă și reguli param: aplicate pe query string-ul vizitatorului (lida.sh/promo?src=newsletter). Cheile sunt case-sensitive, valorile se compară exact, maximum 10 reguli per variantă. Virgulele separă valorile din --when, așa că valoarea unui parametru nu poate conține virgulă; folosește | pentru liste.

Sintaxă op JSON Se potrivește când
param:KEY=VALUE equals valoarea este exact VALUE
param:KEY!=VALUE notEquals valoarea diferă sau cheia lipsește
param:KEY~=VALUE includes valoarea conține VALUE
param:KEY^=VALUE startsWith valoarea începe cu VALUE
param:KEY$=VALUE endsWith valoarea se termină cu VALUE
param:KEY=v1|v2 in valoarea este una din listă
param:KEY? or param:KEY exists cheia este prezentă
param:!KEY missing cheia lipsește
linkdash links variants add promo --name news --url https://example.com/news --when param:src=newsletter
linkdash links variants add promo --name pro --url https://example.com/pro --when "param:plan~=pro"
linkdash links variants add promo --name ref --url https://example.com/ref --when "param:ref?"

Forma JSON: "when": { "params": [{ "key": "src", "op": "equals", "value": "newsletter" }] } (value lipsește pentru exists / missing). Valorile parametrilor sunt verificate în momentul deschiderii și nu sunt stocate niciodată în analytics.

Transmiterea parametrilor de query

--forward-params / --no-forward-params la links create și links update (la nivel de link, dezactivat implicit) adaugă întregul query string al vizitatorului la variantele URL: lida.sh/promo?src=nl deschide https://example.com/?src=nl. Valorile vizitatorului le suprascriu pe cele salvate, inclusiv --utm-*. Variantele de tip fișier și text îl ignoră. Asta e rutare, nu control al accesului: oricine poate adăuga parametri. Valorile parametrilor nu sunt stocate în analytics. links get îl afișează ca forwardParams.

Sticky și restart split

links update <id> --sticky / --no-sticky stabilește dacă un vizitator care revine păstrează aceeași variantă. links update <id> --restart-split reamestecă atribuirile sticky. Flagurile de conținut din links update funcționează doar pentru linkurile cu o singură variantă; altfel folosește links variants update <id> <name>.

Foldere

Un folder este un link care listează elementele pe care le pui în el. Vezi Foldere ca să afli cum funcționează pagina publică și accesul.

linkdash links create --folder "Q4 launch" --slug q4
linkdash links create --file ./deck.pdf --in q4
linkdash links move k3m9xq --in q4
linkdash links move k3m9xq --root
linkdash links list --in q4
linkdash links copy k3m9xq
linkdash links delete q4 --with-contents

--folder <name> setează numele folderului (nu --name) și acceptă --slug, --domain, --password, --starts, --expires, --max-openings, --tag, --preview-* și --in. Nu poate fi combinat cu --url, --file, --text sau --variant. links move afișează {id, folder}. links copy păstrează nivelul de acces, dar primește un URL de partajare nou; persoanele nu sunt copiate. links delete pe un folder mută elementele lui cu un nivel mai sus; --with-contents le șterge și pe ele. Rândurile din list, get și create includ folder (slug-ul folderului care îl conține, sau null); rândurile de folder includ și items.

Acces și partajare

Linkurile și folderele noi sunt restricted: url-ul lor este https://linkdash.dev/s/<token>, pe care îl pot deschide doar tu și persoanele cu care îl partajezi, după autentificare. --access link face acel URL accesibil oricui îl are. --access public servește linkul la URL-ul scurt (lida.sh/<slug> sau domeniul tău personalizat). Folosește --access public pentru linkurile pe care le publici. Slug-ul rămâne id-ul folosit în fiecare comandă, iar URL-ul lui scurt rămâne rezervat cât timp linkul nu e public. Vezi Partajare și acces pentru modelul complet.

linkdash links create --url https://example.com/launch --access public
linkdash links share q4 --email anna@example.com --email ben@example.com
linkdash links shares q4
linkdash links unshare q4 --email ben@example.com
linkdash links shared
linkdash links leave https://linkdash.dev/s/<token>
linkdash links share q4 --email cara@example.com --role editor
linkdash links role q4 --email cara@example.com --role viewer
linkdash links unlock https://linkdash.dev/s/<token>
linkdash links activity q4
linkdash links shares
linkdash links update q4 --access link
linkdash links reset-link q4
Comandă Afișează
links share <id> --email <e> [--email <e> …] {id, url, access, invited, alreadyShared}
links unshare <id> --email <e> {id, email, removed: true}
links shares <id> {id, access, url, people: [{email, role: "viewer", accepted, invitedAt, viaFolder?}]}
links shares (fără id) {items: [{id, name?, kind, access, url, people: [{email, accepted, invitedAt}]}], cursor}, cele partajate cel mai recent primele
links shared {items: [{_id, _creationTime, kind, title?, status, hasPassword, access, url, itemCount?, sharedBy?, sharedAt}], cursor}, cele mai noi primele
links leave <_id | share URL> {_id, left: true}
links role <id> --email <e> --role <r> {id, email, role}
links unlock <_id | share URL> {_id, variant, unlocked: true, minutes: 30, kind, destinationUrl? | textContent? | fileName?}
links activity <id> {items: [{_id, _creationTime, action, detail?, actor}], cursor}
links reset-link <id> (sau links update <id> --reset-share-link) {id, access, url}

--role editor face pe cineva editor: poate modifica elementul și îi poate vedea statisticile, dar nu poate schimba parolele, slug-ul, domeniul, accesul sau partajarea și nu poate șterge, muta sau copia elementul, iar pentru o țintă protejată cu parolă are nevoie mai întâi de links unlock (30 de minute). Editorii folosesc _id-ul sau URL-ul de partajare din links shared. Toate comenzile acceptă --domain <host> când slug-ul se repetă. url din outputul comenzilor create, get, list, update, copy și share este URL-ul de partajare, iar dacă linkul e public, URL-ul scurt; rândurile includ access. Până la 200 de persoane per element, 50 de emailuri per apel, 100 de emailuri de invitație per cont pe zi. Cele două liste afișează câte o pagină: --limit este 1-100 (implicit 50); transmite --cursor din pagina anterioară până când cursor devine null. links leave acceptă _id-ul sau url-ul din links shared; accesul obținut printr-un folder partajat de deasupra rămâne. Partajarea, anularea partajării, o schimbare de acces și o resetare contează fiecare ca un eveniment; părăsirea nu.

Statistici

linkdash links stats <id> --last 24h

--last este o durată (24h, 7d). Implicit 24h. JSON-ul include visits, downloads, plays, visitsInLast, countries, referrers, variants (totaluri per variantă), visitors (fiecare cu variant) și crawlers ([{crawler, company, category, hits, lastSeen}]: boți și preview-uri de linkuri care au accesat linkul, niciodată numărați ca vizite).

CSV

Coloane: slug,kind,name,variant,url,text,fileName,status,domain,tags,starts,expires,maxOpenings,weight,when,created,folder,access. Un rând per variantă. kind, status, url, text, fileName, weight și when (string JSON) sunt per variantă; restul sunt per link și se repetă. folder este slug-ul folderului în care se află linkul. access este restricted, link sau public. Nu se exportă parole, tokenuri de partajare sau persoane.

linkdash links export > links.csv
linkdash links import links.csv

Importul grupează rândurile după slug + domeniu. Primul rând creează linkul cu varianta lui; rândurile următoare adaugă variante. Pentru un link existent, primul rând actualizează câmpurile linkului, apoi fiecare rând actualizează varianta cu numele respectiv dacă există, altfel o adaugă. Rândurile de fișier fără conținut sunt sărite, cu o eroare per rând. Rândurile cu kind = folder (cu un name) creează foldere; coloana folder plasează fiecare link în folderul lui după ce toate rândurile au fost create. Un access gol face linkurile noi restricționate și le lasă neschimbate pe cele existente.

Exemple

linkdash links create --url https://example.com/q4/deck.pdf --slug deck --name "Q4 deck"
linkdash links create --file ./deck.pdf --expires 7d --starts 1d
linkdash links create --url https://example.com --max-openings 1
linkdash links update k3m9xq --max-openings 5
linkdash links update k3m9xq --clear-max-openings
linkdash links create --text "release checklist" --tag launch --tag q4
linkdash links list --q deck --tag launch --kind file --status paused
linkdash links get welcome --domain go.example.com
linkdash links update deck --file ./new.pdf
linkdash links update k3m9xq --status paused
linkdash links create --slug promo --variant a --url https://example.com/a --variant b --url https://example.com/b --weight 3
linkdash links variants add promo --name mobile --url https://m.example.com --when device=mobile
linkdash links update promo --no-sticky --restart-split
linkdash links create --folder "Q4 launch" --slug q4
linkdash links move k3m9xq --in q4
linkdash links create --url https://example.com/launch --access public
linkdash links share q4 --email anna@example.com

Vezi și foldere, partajare și acces, webhookuri și domenii personalizate.

Ți-a fost utilă această pagină?