Hopp til innhold
LinkdashLinkdash
Norsk
Esc
↑↓naviger↵åpne⌘Jforhåndsvis
På denne siden

CLI

Installer linkdash-cli fra npm, og kjør deretter `linkdash`-kommandoen. Vellykkede kommandoer skriver JSON til stdout. Hjelp og feil 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 heter linkdash-cli. Kommandoen heter linkdash.

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

Det finnes ikke noe --json-flagg. Avslutningskoden er 1 ved feil.

Autentisering

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

Har du ikke konto ennå? auth create åpner https://linkdash.dev/sign-up og sender deg deretter tilbake til https://linkdash.dev/device med CLI-koden, slik at du kan godkjenne. Har du allerede en konto? auth login åpner /device. Uten nettleser (headless): sett LINKDASH_TOKEN til et sesjonstoken fra auth create eller auth login. Ikke dikt opp tokens.

Sesjonsfil: ~/.config/linkdash/config.json (modus 0600).

CLI-et kan ikke endre e-post, passord eller fakturering. Send brukeren til dashbordet. API-nøkler (HTTP og MCP): API-nøkler.

Kommandoer

linkdash <command> [options]
Kommando Hva den gjør
auth create Registrering i nettleseren, deretter enhetsgodkjenning
auth login Enhetsinnlogging i nettleseren
auth logout Glem den lagrede sesjonen
auth whoami JSON for den innloggede kontoen
links list List lenker og mapper, én side om gangen (--limit, --cursor)
links get <id> Én lenke
links create --url <url> Kortlenke fra en URL
links create --file <path> Last opp en fil og få en lenke
links create --text <text> Lagre en tekstbit
links create --folder <name> Opprett en mappe
links create --variant <name> … Lenke med flere varianter (splitt / målretting)
links update <id> Endre mål, fil, passord, utløp, domene, status, sticky eller videresendte parametere
links move <id> --in <folder-id> Legg en lenke eller mappe i en mappe (--root for toppnivået)
links copy <id> Lag en kopi med ny slug, i samme mappe
links delete <id> Slett en lenke (elementene i en mappe flyttes opp; --with-contents sletter dem)
links share <id> --email <email> Del med personer via e-post (gjenta --email; --role editor lar dem endre det; hver nye person får en invitasjon på e-post)
links unshare <id> --email <email> Fjern noens tilgang
links shares [id] Hvem andre enn deg som kan åpne det, også via en mappe over det. Uten id: alt du har invitert folk til, én side om gangen (--limit, --cursor)
links shared Det andre har delt med deg, én side om gangen (--limit, --cursor)
links leave <_id | share URL> Gi fra deg noe som er delt med deg
links role <id> --email <e> --role viewer|editor Gjør en du har invitert til leser eller redaktør
links unlock <_id | share URL> Oppgi passordet til et delt element for å se og redigere målet i 30 minutter
links activity <id> Hvem som endret et element, og hvordan
links reset-link <id> Ny delings-URL; den gamle linkdash.dev/s/-URL-en slutter å virke
links stats <id> Totalt antall besøk, nedlastinger og avspillinger, også per variant, pluss crawlere
links export Skriv ut alle lenker som CSV (én rad per variant)
links import <file> Importer URL- og tekstrader fra CSV
links variants list <id> Variantene til en lenke
links variants add <id> --name <n> Legg til en variant
links variants update <id> <name> Endre en variant
links variants remove <id> <name> Fjern en variant
webhooks list List webhook-endepunkter (hemmeligheten er maskert)
webhooks get <id> Vis én webhook-URL (hemmeligheten er maskert)
webhooks create --url <https> Legg til et HTTPS-endepunkt (hemmeligheten vises én gang)
webhooks rotate <id> Utsted en ny signeringshemmelighet
webhooks delete <id> Fjern en webhook
domains list List egendefinerte vertsnavn
domains add <host> Legg til et vertsnavn (1 på Free)
domains connect <host> Domain Connect-URL for å ta i bruk domenet, eller null
domains verify <host> Sjekk DNS med Unkey
domains remove <host> Fjern et vertsnavn
-h, --help Hjelp (ren tekst)
-v, --version Versjon

Hvis samme slug finnes på to av eierens domener, sender du med --domain.

Flagg for opprettelse og oppdatering

Slug er lenkens id, og den offentlige stien når lenken er offentlig. Navnet er bare synlig for deg. Nye lenker er begrensede (se Tilgang og deling). Create tar nøyaktig én av --url, --file eller --text (som blir varianten main), --variant-blokker (se Varianter) eller --folder <name> (se Mapper).

Flagg Merknader
--url <url> Mål-URL
--file <path> Fil som skal lastes opp (ved opprettelse, eller for å erstatte innholdet ved oppdatering)
--text <text> Tekstbit
--access <restricted|link|public> Hvem som kan åpne den. Standard er restricted. Se Tilgang og deling
--reset-share-link Utsted en ny delings-URL (kun update)
--slug <id> Offentlig sti: a-z0-9 og bindestreker inni, 1–64 tegn
--name <label> Privat etikett
--tag <tag> Kan gjentas. Små bokstaver, ingen kommaer. Maks 20
--starts <when> Gå live etter 7d, 24h, 30m eller på en ISO-dato
--password <secret> Krev dette passordet for å åpne
--expires <when> Slutt å levere etter 7d, 24h, 30m eller på en ISO-dato
--max-openings <n> Sett på pause etter så mange åpninger. Utelat for ubegrenset
--domain <host> Lever på denne verten i stedet for lida.sh
--in <folder-id> Opprett i denne mappen (kun create; --in-domain <host> hvis mappens slug går igjen)
--status <active|paused> Sett på pause eller gjenoppta (kun update)
--sticky / --no-sticky En besøkende som kommer tilbake, beholder samme variant (standard er sticky)
--restart-split Stokk om sticky-tildelingene (kun update)
--forward-params / --no-forward-params Legg den besøkendes spørrestreng til URL-varianter (standard av). Se Videresend spørreparametere
--variant <name> Start en variantblokk (kun create). Se Varianter
--weight <n> --when <key=v1,v2> Per variant. Se Varianter og Regler for spørreparametere
--preview-name <text> Offentlig navn i lenkeforhåndsvisningen
--preview-description <text> Offentlig beskrivelse i lenkeforhåndsvisningen
--preview-image <path> Offentlig bilde i lenkeforhåndsvisningen
--utm-source --utm-medium --utm-campaign --utm-term --utm-content Kun URL-lenker
--clear-password --clear-expires --clear-starts --clear-tags --clear-preview --clear-name --clear-max-openings Kun update

--status godtar bare active eller paused. Utløpt kommer fra --expires. Planlagt kommer fra --starts. Offentlig oppslag gir not-found frem til start. Når --max-openings er nådd, settes lenken på pause; øk tallet, eller bruk --clear-max-openings, for å levere den igjen. Åpninger som allerede er brukt, telles med til du endrer eller fjerner grensen.

lida.sh-slugs er delte. Hvis et ord er tatt, legger du til et egendefinert domene og prøver igjen med --domain. En lenke på et merkevaredomene publiseres ikke i tillegg på lida.sh.

Flagg for listing

Skriver ut én side, {items, cursor}: --limit er 1-100 (standard 50); send med --cursor med cursor fra forrige side til den er null. En side kan inneholde færre elementer enn --limit når et filter hopper over noen. --q matcher hele ord, der det siste ordet behandles som prefiks (laun finner example.com/launch), rangert etter relevans; --in lister én mappe, med mapper først; ellers vises nyeste først.

Flagg Merknader
--limit <n> Elementer per side, 1-100 (standard 50)
--cursor <c> cursor fra forrige side
--q <text> Søk etter ord i navn, slug, variantnavn og -mål, filnavn, tekstbiter og tagger
--tag <tag> Filtrer etter tagg
--kind <url|file|text|folder|group> Filtrer etter type (group = flere varianter)
--status <status> active, paused, expired, scheduled eller mixed
--in <folder-id|root> Bare det som ligger direkte i denne mappen, eller på toppnivået. Uten flagget listes alt

Varianter

Hver lenke er en beholder for én eller flere varianter. En variant er innholdet (URL, fil eller tekst) pluss egne tilgangsbetingelser (--password, --starts, --expires, --max-openings), en --weight og valgfrie betingelser for besøkende (--when). Uten --variant har en lenke én variant som heter main, og hver kommando over er en kortform for den. En besøkende får én variant: variantene der --when matcher, utgjør utvalget (hvis ingen matcher, brukes de ubetingede variantene), og deretter gjøres et vektet valg. Med sticky-tildeling (standard) beholder en besøkende som kommer tilbake, samme variant. Lenkens egne tilgangsbetingelser går foran variantenes. Variantnavn: små bokstaver, sifre og bindestreker inni, 1–40 tegn, unike per lenke. Maks 20 varianter.

Lenkens kind er variantens type når det er én variant, og group når det er flere. Lenkens status er lenkens tilgangsbetingelse når den er satt (paused, scheduled, expired), ellers den felles variantstatusen, ellers mixed. variantStatuses teller {active, paused, expired, scheduled}.

Opprett med variantblokker

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 variantblokk. Flagg etter den hører til den varianten frem til neste --variant: --url|--file|--text, --password, --starts, --expires, --max-openings, --weight <n>, --when <key=v1,v2> (kan gjentas), --utm-*. Lenkeflagg (--slug --name --tag --domain --preview-* --password --starts --expires --max-openings --sticky --no-sticky --forward-params) kommer før første --variant.

Underkommandoer for 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> tar én av --url, --file, --text, pluss flagg for tilgangsbetingelser, --weight, --when, --utm-*. variants update <id> <name> tar --name <new>, innhold, flagg for tilgangsbetingelser, --status active|paused, --weight, --when, --clear-when, --clear-password, --clear-starts, --clear-expires, --clear-max-openings. En lenke beholder alltid minst én variant.

--when-nøkler

Nøkkel JSON-felt Verdier
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 prefiksmatch (de, en-us)
referrer referrerHosts vertssuffiks (twitter.com)

Alle nøkler som er satt, må matche. --when country=DE,AT --when device=mobile blir { "countries": ["DE","AT"], "devices": ["mobile"] }.

Regler for spørreparametere

--when tar også param:-regler for den besøkendes spørrestreng (lida.sh/promo?src=newsletter). Nøkler skiller mellom store og små bokstaver, verdier sammenlignes eksakt, og det er maks 10 regler per variant. Komma deler opp --when, så en parameterverdi kan ikke inneholde komma; bruk | for lister.

Syntaks JSON op Matcher når
param:KEY=VALUE equals verdien er nøyaktig VALUE
param:KEY!=VALUE notEquals verdien er en annen, eller nøkkelen mangler
param:KEY~=VALUE includes verdien inneholder VALUE
param:KEY^=VALUE startsWith verdien starter med VALUE
param:KEY$=VALUE endsWith verdien slutter med VALUE
param:KEY=v1|v2 in verdien er en av verdiene i listen
param:KEY? or param:KEY exists nøkkelen finnes
param:!KEY missing nøkkelen 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 utelates for exists / missing). Parameterverdier matches når lenken åpnes, og lagres aldri i analysedataene.

Videresend spørreparametere

--forward-params / --no-forward-params på links create og links update (på lenkenivå, av som standard) legger hele den besøkendes spørrestreng til URL-varianter: lida.sh/promo?src=nl åpner https://example.com/?src=nl. Verdier fra den besøkende overstyrer lagrede verdier, også --utm-*. Fil- og tekstvarianter ignorerer innstillingen. Dette er ruting, ikke tilgangskontroll: hvem som helst kan legge til parametere. Parameterverdier lagres ikke i analysedataene. links get viser innstillingen som forwardParams.

Sticky og omstart av splitt

links update <id> --sticky / --no-sticky angir om en besøkende som kommer tilbake, beholder samme variant. links update <id> --restart-split stokker om sticky-tildelingene. Innholdsflagg på links update virker bare for lenker med én variant; ellers bruker du links variants update <id> <name>.

Mapper

En mappe er en lenke som lister elementene du legger i den. Se Mapper for hvordan den offentlige siden og tilgangen 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> angir mappenavnet (ikke --name) og tar --slug, --domain, --password, --starts, --expires, --max-openings, --tag, --preview-* og --in. Det kan ikke kombineres med --url, --file, --text eller --variant. links move skriver ut {id, folder}. links copy beholder tilgangsnivået, men får en ny delings-URL; personer kopieres ikke. links delete på en mappe flytter elementene ett nivå opp; --with-contents sletter dem også. Rader fra list, get og create inkluderer folder (sluggen til mappen elementet ligger i, eller null); mapperader inkluderer også items.

Tilgang og deling

Nye lenker og mapper er restricted: url er https://linkdash.dev/s/<token>, som bare du og de du deler med kan åpne, når de er innlogget. --access link åpner den URL-en for alle som har den. --access public leverer lenken på kort-URL-en (lida.sh/<slug> eller ditt egendefinerte domene). Bruk --access public for lenker du legger ut offentlig. Sluggen er fortsatt id-en for alle kommandoer, og kort-URL-en forblir reservert så lenge lenken ikke er offentlig. Se Deling og tilgang 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 Skriver ut
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 (uten id) {items: [{id, name?, kind, access, url, people: [{email, accepted, invitedAt}]}], cursor}, sist delt 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 gjør noen til redaktør: de kan endre elementet og se statistikken, men ikke passord, slug, domene, tilgang eller deling, og de kan ikke slette, flytte eller kopiere. Et passordbeskyttet mål krever dessuten links unlock først (30 minutter). Redaktører bruker _id eller delings-URL-en fra links shared. Alle kommandoene tar --domain <host> når sluggen går igjen. url i utdata fra create, get, list, update, copy og share er delings-URL-en, med mindre lenken er offentlig – da er det kort-URL-en; rader inkluderer access. Opptil 200 personer per element, 50 e-postadresser per kall og 100 invitasjoner på e-post per konto per dag. De to listene skriver ut én side: --limit er 1-100 (standard 50); send med --cursor fra forrige side til cursor er null. links leave tar _id eller url fra links shared; tilgang via en delt mappe lenger opp beholdes. Deling, oppheving av deling, en tilgangsendring og en tilbakestilling teller hver som én hendelse; å forlate gjør det ikke.

Statistikk

linkdash links stats <id> --last 24h

--last er en varighet (24h, 7d). Standard er 24h. JSON inkluderer visits, downloads, plays, visitsInLast, countries, referrers, variants (totaler per variant), visitors (hver med variant) og crawlers ([{crawler, company, category, hits, lastSeen}]: boter og lenkeforhåndsvisninger som har hentet lenken, og som aldri telles som besøk).

CSV

Kolonner: slug,kind,name,variant,url,text,fileName,status,domain,tags,starts,expires,maxOpenings,weight,when,created,folder,access. Én rad per variant. kind, status, url, text, fileName, weight og when (JSON-streng) gjelder per variant; resten gjelder per lenke og gjentas. folder er sluggen til mappen lenken ligger i. access er restricted, link eller public. Ingen passord, delingstokens eller personer.

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

Import grupperer rader etter slug + domene. Den første raden oppretter lenken med varianten sin; flere rader legger til varianter. For en eksisterende lenke oppdaterer den første raden lenkefeltene, og deretter oppdaterer hver rad varianten med det navnet hvis den finnes, ellers legges den til. Filrader uten innhold hoppes over med en feil for den enkelte raden. Rader med kind = folder (med en name) oppretter mapper; folder-kolonnen plasserer hver lenke i mappen sin etter at alle radene finnes. En tom access gjør nye lenker begrensede og lar eksisterende lenker 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 tilgang, webhooks og egendefinerte domener.

Var denne siden nyttig?