Spring til indhold
LinkdashLinkdash
Dansk
Esc
↑↓navigér↵åbn⌘Jforhåndsvis
På denne side

CLI

Installér linkdash-cli fra npm, og kør derefter kommandoen `linkdash`. Kommandoer, der lykkes, skriver JSON til stdout. Hjælp og fejl er ren tekst på stderr.

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

npm-pakken hedder linkdash-cli. Kommandoen hedder linkdash.

Tilsvarende over HTTP: HTTP API. MCP: MCP. Agent-skill: Agent-skill. Priser: Priser. Ren markdown: cli.md.

Der findes ikke noget --json-flag. Ved fejl er exitkoden 1.

Godkendelse

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

Har du ikke en konto endnu? auth create åbner https://linkdash.dev/sign-up og sender dig derefter videre til https://linkdash.dev/device med CLI-koden, så du kan godkende. Har du allerede en konto? auth login åbner /device. Uden browser: Sæt LINKDASH_TOKEN til et sessionstoken fra auth create eller auth login. Find ikke selv på tokens.

Sessionsfil: ~/.config/linkdash/config.json (mode 0600).

CLI’en kan ikke ændre e-mail, adgangskode eller betaling. Send brugeren til dashboardet. API-nøgler (HTTP og MCP): API-nøgler.

Kommandoer

linkdash <command> [options]
Kommando Hvad den gør
auth create Tilmelding i browseren, derefter godkendelse af enheden
auth login Login på enheden via browseren
auth logout Glem den gemte session
auth whoami JSON for den konto, du er logget ind med
links list Vis links og mapper, én side ad gangen (--limit, --cursor)
links get <id> Ét link
links create --url <url> Kort link fra en URL
links create --file <path> Upload en fil og få et link
links create --text <text> Gem et tekststykke
links create --folder <name> Opret en mappe
links create --variant <name> … Link med flere varianter (split / målretning)
links update <id> Skift destination, fil, adgangskode, udløb, domæne, status, sticky eller videresendte parametre
links move <id> --in <folder-id> Læg et link eller en mappe i en mappe (--root for øverste niveau)
links copy <id> Lav en kopi med en ny slug i samme mappe
links delete <id> Slet et link (indholdet i en mappe rykker et niveau op; --with-contents sletter det)
links share <id> --email <email> Del med folk via e-mail (gentag --email; --role editor lader dem ændre det; hver ny person får en invitation på e-mail)
links unshare <id> --email <email> Fjern en persons adgang
links shares [id] Hvem der ud over dig kan åbne det, også via en mappe længere oppe. Uden id: alt, du har inviteret folk til, én side ad gangen (--limit, --cursor)
links shared Det, andre har delt med dig, én side ad gangen (--limit, --cursor)
links leave <_id | share URL> Opgiv noget, der er delt med dig
links role <id> --email <e> --role viewer|editor Gør en, du har inviteret, til læser eller redaktør
links unlock <_id | share URL> Indtast adgangskoden til et delt element for at se og redigere dets mål i 30 minutter
links activity <id> Hvem der har ændret et element, og hvordan
links reset-link <id> Ny delings-URL; den gamle linkdash.dev/s/-URL holder op med at virke
links stats <id> Totaler for besøg, downloads og afspilninger, også pr. variant, plus crawlere
links export Udskriv alle links som CSV (én række pr. variant)
links import <file> Importér URL- og tekstrækker fra CSV
links variants list <id> Et links varianter
links variants add <id> --name <n> Tilføj en variant
links variants update <id> <name> Ændr en variant
links variants remove <id> <name> Fjern en variant
webhooks list Vis webhook-endpoints (secret maskeret)
webhooks get <id> Vis én webhook-URL (secret maskeret)
webhooks create --url <https> Tilføj et HTTPS-endpoint (secret vises én gang)
webhooks rotate <id> Udsted en ny signerings-secret
webhooks delete <id> Fjern en webhook
domains list Vis egne værtsnavne
domains add <host> Tilføj et værtsnavn (1 på Free)
domains connect <host> Domain Connect-URL til opsætning, eller null
domains verify <host> Tjek DNS med Unkey
domains remove <host> Fjern et værtsnavn
-h, --help Hjælp (ren tekst)
-v, --version Version

Hvis den samme slug findes på to af ejerens domæner, skal du angive --domain.

Flag til oprettelse og opdatering

Slug er linkets id og dets offentlige sti, når linket er offentligt. Navnet er kun synligt for dig. Nye links er begrænsede (se Adgang og deling). Oprettelse tager præcis én af --url, --file eller --text (som bliver til varianten main), --variant-blokke (se Varianter) eller --folder <name> (se Mapper).

Flag Noter
--url <url> Destinations-URL
--file <path> Fil, der skal uploades (ved oprettelse, eller erstat indholdet ved opdatering)
--text <text> Tekststykke
--access <restricted|link|public> Hvem der kan åbne det. Standard er restricted. Se Adgang og deling
--reset-share-link Udsted en ny delings-URL (kun ved opdatering)
--slug <id> Offentlig sti: a-z0-9 og bindestreger inde i ordet, 1–64
--name <label> Privat etiket
--tag <tag> Kan gentages. Små bogstaver, ingen kommaer. Maks. 20
--starts <when> Gå live efter 7d, 24h, 30m eller en ISO-dato
--password <secret> Kræv denne adgangskode for at åbne
--expires <when> Stop med at levere efter 7d, 24h, 30m eller en ISO-dato
--max-openings <n> Sæt på pause efter så mange åbninger. Udelad for ubegrænset
--domain <host> Lever på denne vært i stedet for lida.sh
--in <folder-id> Opret inde i denne mappe (kun ved oprettelse; --in-domain <host>, hvis mappens slug går igen)
--status <active|paused> Sæt på pause eller genoptag (kun ved opdatering)
--sticky / --no-sticky En tilbagevendende besøgende beholder den samme variant (standard er sticky)
--restart-split Bland sticky-tildelingerne på ny (kun ved opdatering)
--forward-params / --no-forward-params Tilføj den besøgendes query string til URL-varianter (standard er slået fra). Se Videresend query-parametre
--variant <name> Start en variantblok (kun ved oprettelse). Se Varianter
--weight <n> --when <key=v1,v2> Pr. variant. Se Varianter og Regler for query-parametre
--preview-name <text> Offentligt navn i linkforhåndsvisning
--preview-description <text> Offentlig beskrivelse i linkforhåndsvisning
--preview-image <path> Offentligt billede i linkforhåndsvisning
--utm-source --utm-medium --utm-campaign --utm-term --utm-content Kun URL-links
--clear-password --clear-expires --clear-starts --clear-tags --clear-preview --clear-name --clear-max-openings Kun ved opdatering

--status accepterer kun active eller paused. Udløbet kommer fra --expires. Planlagt kommer fra --starts. Offentlig opslag giver not-found indtil start. Når --max-openings er nået, sættes linket på pause; hæv tallet eller brug --clear-max-openings for at levere det igen. Åbninger, der allerede er brugt, tæller stadig, indtil du ændrer eller fjerner grænsen.

Slugs på lida.sh er fælles. Hvis et ord er taget, så tilføj et eget domæne og prøv igen med --domain. Et link på et brandet domæne bliver ikke også udgivet på lida.sh.

Flag til list

Udskriver én side, {items, cursor}: --limit er 1-100 (standard 50); angiv --cursor med cursor fra den forrige side, indtil den er null. En side kan indeholde færre elementer end --limit, når et filter springer nogle over. --q matcher hele ord, hvor det sidste bruges som præfiks (laun finder example.com/launch), sorteret efter relevans; --in viser én mappe med mapper først; ellers nyeste først.

Flag Noter
--limit <n> Elementer pr. side, 1-100 (standard 50)
--cursor <c> cursor fra den forrige side
--q <text> Søg efter ord i navn, slug, variantnavne og -mål, filnavne, tekststykker og tags
--tag <tag> Filtrér efter tag
--kind <url|file|text|folder|group> Filtrér efter type (group = flere varianter)
--status <status> active, paused, expired, scheduled eller mixed
--in <folder-id|root> Kun det, der ligger direkte i denne mappe eller på øverste niveau. Uden flaget vises alt

Varianter

Hvert link er en beholder med én eller flere varianter. En variant er indholdet (URL, fil eller tekst) plus dens egen spærre (--password, --starts, --expires, --max-openings), en --weight og valgfrie betingelser for besøgende (--when). Uden --variant har et link én variant ved navn main, og alle kommandoerne ovenfor er en genvej til den. En besøgende får én variant: Varianter, hvis --when matcher, udgør puljen (hvis ingen matcher, gør de ubetingede varianter), og derefter vælges der vægtet. Med sticky-tildeling (standard) beholder en tilbagevendende besøgende den samme variant. Linkets egen spærre vinder over variantspærrer. Variantnavne: små bogstaver, cifre, bindestreger inde i ordet, 1–40 tegn, unikke pr. link. Maks. 20 varianter.

Linkets kind er variantens type ved én variant og group ved flere. Linkets status er linkspærren, når den er sat (paused, scheduled, expired), ellers den fælles variantstatus, ellers mixed. variantStatuses tæller {active, paused, expired, scheduled}.

Opret med variantblokke

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> starter en variantblok. Flag efter den hører til den variant indtil næste --variant: --url|--file|--text, --password, --starts, --expires, --max-openings, --weight <n>, --when <key=v1,v2> (kan gentages), --utm-*. Linkflag (--slug --name --tag --domain --preview-* --password --starts --expires --max-openings --sticky --no-sticky --forward-params) skal stå før den første --variant.

Underkommandoer til varianter

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> tager én af --url, --file, --text plus spærreflag, --weight, --when, --utm-*. variants update <id> <name> tager --name <new>, indhold, spærreflag, --status active|paused, --weight, --when, --clear-when, --clear-password, --clear-starts, --clear-expires, --clear-max-openings. Et link har altid mindst én variant.

--when-nøgler

Nøgle JSON-felt Værdier
country countries ISO-2-koder (DE, AT)
device devices mobile tablet desktop
os os windows macos android ios linux other
browser browsers edge chrome firefox safari other
language languages præfiksmatch (de, en-us)
referrer referrerHosts værtssuffiks (twitter.com)

Alle angivne nøgler skal matche. --when country=DE,AT --when device=mobile svarer til { "countries": ["DE","AT"], "devices": ["mobile"] }.

Regler for query-parametre

--when tager også param:-regler for den besøgendes query string (lida.sh/promo?src=newsletter). Nøgler skelner mellem store og små bogstaver, værdier sammenlignes præcist, og der er maks. 10 regler pr. variant. Kommaer deler --when op, så en parameterværdi kan ikke indeholde et komma; brug | til lister.

Syntaks JSON op Matcher, når
param:KEY=VALUE equals værdien er præcis VALUE
param:KEY!=VALUE notEquals værdien er en anden, eller nøglen mangler
param:KEY~=VALUE includes værdien indeholder VALUE
param:KEY^=VALUE startsWith værdien starter med VALUE
param:KEY$=VALUE endsWith værdien slutter med VALUE
param:KEY=v1|v2 in værdien er en af dem på listen
param:KEY? eller param:KEY exists nøglen findes
param:!KEY missing nøglen mangler
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?"

JSON-form: "when": { "params": [{ "key": "src", "op": "equals", "value": "newsletter" }] } (value udelades for exists / missing). Parameterværdier matches, når linket åbnes, og gemmes aldrig i analytics.

Videresend query-parametre

--forward-params / --no-forward-params på links create og links update (på linkniveau, slået fra som standard) tilføjer den besøgendes hele query string til URL-varianter: lida.sh/promo?src=nl åbner https://example.com/?src=nl. Den besøgendes værdier overskriver de gemte, også --utm-*. Fil- og tekstvarianter ignorerer det. Det er routing, ikke adgangskontrol: Alle kan tilføje parametre. Parameterværdier gemmes ikke i analytics. links get viser det som forwardParams.

Sticky og genstart af split

links update <id> --sticky / --no-sticky bestemmer, om en tilbagevendende besøgende beholder den samme variant. links update <id> --restart-split blander sticky-tildelingerne på ny. Indholdsflag på links update virker kun for links med én variant; ellers skal du bruge links variants update <id> <name>.

Mapper

En mappe er et link, der viser de elementer, du lægger i den. Se Mapper for, hvordan den offentlige side og adgang fungerer.

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> sætter mappens navn (ikke --name) og tager --slug, --domain, --password, --starts, --expires, --max-openings, --tag, --preview-* og --in. Det kan ikke kombineres med --url, --file, --text eller --variant. links move udskriver {id, folder}. links copy beholder adgangsniveauet, men får en ny delings-URL; personer kopieres ikke med. links delete på en mappe rykker dens elementer et niveau op; --with-contents sletter dem også. Rækker fra list, get og create indeholder folder (slug for den mappe, de ligger i, eller null); mapperækker indeholder også items.

Adgang og deling

Nye links og mapper er restricted: Deres url er https://linkdash.dev/s/<token>, som kun du og de personer, du deler med, kan åbne, når de er logget ind. --access link åbner den URL for alle, der har den. --access public leverer linket på dets korte URL (lida.sh/<slug> eller dit eget domæne). Brug --access public til links, du offentliggør. Slug forbliver id’et for alle kommandoer, og dens korte URL forbliver reserveret, mens linket ikke er offentligt. Se Deling og adgang for hele modellen.

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
Kommando Udskriver
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 (uden id) {items: [{id, name?, kind, access, url, people: [{email, accepted, invitedAt}]}], cursor}, senest delte først
links shared {items: [{_id, _creationTime, kind, title?, status, hasPassword, access, url, itemCount?, sharedBy?, sharedAt}], cursor}, nyeste først
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> (eller links update <id> --reset-share-link) {id, access, url}

--role editor gør en person til redaktør: De kan ændre elementet og se dets statistik, men ikke adgangskoder, slug, domæne, adgang eller deling, og de kan ikke slette, flytte eller kopiere. Et adgangskodebeskyttet mål kræver først links unlock (30 minutter). Redaktører bruger _id eller delings-URL’en fra links shared. Alle tager --domain <host>, når slug går igen. url i output fra create, get, list, update, copy og share er delings-URL’en, medmindre linket er offentligt – så er det den korte URL; rækker indeholder access. Op til 200 personer pr. element, 50 e-mails pr. kald og 100 invitationsmails pr. konto pr. dag. De to lister udskriver én side: --limit er 1-100 (standard 50); angiv --cursor fra den forrige side, indtil cursor er null. links leave tager _id eller url fra links shared; adgang via en delt mappe længere oppe bevares. Deling, fjernelse af deling, en adgangsændring og en nulstilling tæller hver som én hændelse; at forlade gør ikke.

Statistik

linkdash links stats <id> --last 24h

--last er en varighed (24h, 7d). Standard er 24h. JSON indeholder visits, downloads, plays, visitsInLast, countries, referrers, variants (totaler pr. variant), visitors (hver med variant) og crawlers ([{crawler, company, category, hits, lastSeen}]: bots og linkforhåndsvisninger, der har hentet linket, og som aldrig tælles som besøg).

CSV

Kolonner: slug,kind,name,variant,url,text,fileName,status,domain,tags,starts,expires,maxOpenings,weight,when,created,folder,access. Én række pr. variant. kind, status, url, text, fileName, weight og when (JSON-streng) er pr. variant; resten er pr. link og gentages. folder er slug for den mappe, linket ligger i. access er restricted, link eller public. Ingen adgangskoder, delingstokens eller personer.

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

Import grupperer rækker efter slug + domæne. Den første række opretter linket med dets variant; flere rækker tilføjer varianter. For et eksisterende link opdaterer den første række linkfelterne, og derefter opdaterer hver række varianten med det navn, hvis den findes, ellers tilføjes den. Filrækker uden indhold springes over med en fejl for den række. Rækker med kind = folder (med et name) opretter mapper; kolonnen folder placerer hvert link i sin mappe, når alle rækker findes. En tom access gør nye links begrænsede og lader eksisterende links være, som de er.

Eksempler

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

Se også mapper, deling og adgang, webhooks og egne domæner.

Var denne side nyttig?