Naar inhoud springen
LinkdashLinkdash
Nederlands
Esc
↑↓navigeren↵openen⌘Jvoorbeeld
Op deze pagina

CLI

Installeer linkdash-cli via npm en voer daarna het `linkdash`-commando uit. Geslaagde commando's printen JSON op stdout. Help en fouten zijn platte tekst op stderr.

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

Het npm-pakket heet linkdash-cli. Het commando is linkdash.

HTTP-equivalent: HTTP API. MCP: MCP. Agent-skill: Agent-skill. Prijzen: Prijzen. Platte markdown: cli.md.

Er is geen --json-flag. Bij fouten is de exitcode 1.

Auth

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

Nog geen account? auth create opent https://linkdash.dev/sign-up en brengt je daarna terug naar https://linkdash.dev/device met de CLI-code, zodat je kunt goedkeuren. Heb je al een account? auth login opent /device. Headless: zet LINKDASH_TOKEN op een sessietoken uit auth create of auth login. Verzin geen tokens.

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

De CLI kan geen e-mailadres, wachtwoord of facturering wijzigen. Stuur de gebruiker daarvoor naar het dashboard. API-sleutels (HTTP en MCP): API-sleutels.

Commando’s

linkdash <command> [options]
Commando Wat het doet
auth create Registratie in de browser, daarna goedkeuring van het apparaat
auth login Apparaatlogin via de browser
auth logout De opgeslagen sessie vergeten
auth whoami JSON van het ingelogde account
links list Links en mappen weergeven, één pagina per keer (--limit, --cursor)
links get <id> Eén link
links create --url <url> Korte link van een URL
links create --file <path> Een bestand uploaden en een link krijgen
links create --text <text> Een snippet opslaan
links create --folder <name> Een map maken
links create --variant <name> … Link met meerdere varianten (split / targeting)
links update <id> Bestemming, bestand, wachtwoord, verloopdatum, domein, status, sticky of doorgestuurde parameters wijzigen
links move <id> --in <folder-id> Een link of map in een map plaatsen (--root voor het hoogste niveau)
links copy <id> Een kopie maken met een nieuwe slug, in dezelfde map
links delete <id> Een link verwijderen (de items van een map gaan een niveau omhoog; --with-contents verwijdert ze)
links share <id> --email <email> Met mensen delen via e-mail (herhaal --email; met --role editor kunnen ze het wijzigen; elke nieuwe persoon krijgt een uitnodigingsmail)
links unshare <id> --email <email> Iemands toegang intrekken
links shares [id] Wie het naast jou kan openen, ook via een bovenliggende map. Zonder id: alles waarvoor je mensen hebt uitgenodigd, één pagina per keer (--limit, --cursor)
links shared Wat anderen met je hebben gedeeld, één pagina per keer (--limit, --cursor)
links leave <_id | share URL> Afstand doen van iets dat met je is gedeeld
links role <id> --email <e> --role viewer|editor Iemand die je hebt uitgenodigd viewer of editor maken
links unlock <_id | share URL> Het wachtwoord van een gedeeld item invoeren om het doel 30 minuten te kunnen zien en bewerken
links activity <id> Wie een item heeft gewijzigd en hoe
links reset-link <id> Nieuwe deel-URL; de oude linkdash.dev/s/-URL werkt niet meer
links stats <id> Totalen voor bezoeken, downloads en keren afgespeeld, ook per variant, plus crawlers
links export Alle links als CSV printen (één rij per variant)
links import <file> URL- en tekstrijen uit CSV importeren
links variants list <id> Varianten van een link
links variants add <id> --name <n> Een variant toevoegen
links variants update <id> <name> Een variant wijzigen
links variants remove <id> <name> Een variant verwijderen
webhooks list Webhook-endpoints weergeven (secret gemaskeerd)
webhooks get <id> Eén webhook-URL tonen (secret gemaskeerd)
webhooks create --url <https> Een HTTPS-endpoint toevoegen (secret wordt één keer getoond)
webhooks rotate <id> Een nieuw signing secret uitgeven
webhooks delete <id> Een webhook verwijderen
domains list Eigen hostnamen weergeven
domains add <host> Een hostnaam toevoegen (1 op Free)
domains connect <host> Domain Connect-apply-URL, of null
domains verify <host> DNS controleren met Unkey
domains remove <host> Een hostnaam verwijderen
-h, --help Help (platte tekst)
-v, --version Versie

Bestaat dezelfde slug op twee domeinen van de eigenaar, geef dan --domain mee.

Flags voor create en update

De slug is de id van de link, en het openbare pad als de link openbaar is. De naam is alleen voor jou zichtbaar. Nieuwe links zijn beperkt (zie Toegang en delen). Create accepteert precies één van --url, --file of --text (dat wordt de variant main), --variant-blokken (zie Varianten) of --folder <name> (zie Mappen).

Flag Opmerkingen
--url <url> Bestemmings-URL
--file <path> Te uploaden bestand (bij create, of vervangt de bytes bij update)
--text <text> Snippet
--access <restricted|link|public> Wie het kan openen. Standaard restricted. Zie Toegang en delen
--reset-share-link Een nieuwe deel-URL uitgeven (alleen update)
--slug <id> Openbaar pad: a-z0-9 en koppeltekens binnenin, 1–64
--name <label> Privélabel
--tag <tag> Herhaalbaar. Kleine letters, geen komma’s. Max. 20
--starts <when> Live gaan na 7d, 24h, 30m of op een ISO-datum
--password <secret> Dit wachtwoord vereisen om te openen
--expires <when> Stoppen met serveren na 7d, 24h, 30m of op een ISO-datum
--max-openings <n> Pauzeren na zoveel keer openen. Laat weg voor onbeperkt
--domain <host> Op deze host serveren in plaats van lida.sh
--in <folder-id> In deze map aanmaken (alleen create; --in-domain <host> als de map-slug vaker voorkomt)
--status <active|paused> Pauzeren of hervatten (alleen update)
--sticky / --no-sticky Terugkerende bezoeker houdt dezelfde variant (standaard sticky)
--restart-split Sticky toewijzingen opnieuw verdelen (alleen update)
--forward-params / --no-forward-params De querystring van de bezoeker toevoegen aan URL-varianten (standaard uit). Zie Queryparameters doorsturen
--variant <name> Een variantblok starten (alleen create). Zie Varianten
--weight <n> --when <key=v1,v2> Per variant. Zie Varianten en Regels voor queryparameters
--preview-name <text> Openbare naam voor de linkpreview
--preview-description <text> Openbare beschrijving voor de linkpreview
--preview-image <path> Openbare afbeelding voor de linkpreview
--utm-source --utm-medium --utm-campaign --utm-term --utm-content Alleen URL-links
--clear-password --clear-expires --clear-starts --clear-tags --clear-preview --clear-name --clear-max-openings Alleen update

--status accepteert alleen active of paused. Verlopen volgt uit --expires. Gepland volgt uit --starts. Openbaar resolven geeft not-found tot de starttijd. Zodra --max-openings is bereikt, pauzeert de link; verhoog het aantal, of gebruik --clear-max-openings, om hem weer te serveren. Openingen die al gebruikt zijn, blijven meetellen totdat je de limiet wijzigt of verwijdert.

lida.sh-slugs worden gedeeld. Is een woord al bezet, voeg dan een eigen domein toe en probeer het opnieuw met --domain. Een link op een eigen domein wordt niet ook op lida.sh gepubliceerd.

Flags voor list

Print één pagina, {items, cursor}: --limit is 1-100 (standaard 50); geef --cursor mee met de cursor van de vorige pagina, totdat die null is. Een pagina kan minder items bevatten dan --limit als een filter er een paar overslaat. --q matcht hele woorden, waarbij het laatste woord als prefix telt (laun vindt example.com/launch), gerangschikt op relevantie; --in toont één map, met mappen eerst; anders staat het nieuwste bovenaan.

Flag Opmerkingen
--limit <n> Items per pagina, 1-100 (standaard 50)
--cursor <c> De cursor van de vorige pagina
--q <text> Zoekt woorden in de naam, slug, variantnamen en -doelen, bestandsnamen, snippettekst en tags
--tag <tag> Filteren op tag
--kind <url|file|text|folder|group> Filteren op soort (group = meerdere varianten)
--status <status> active, paused, expired, scheduled of mixed
--in <folder-id|root> Alleen wat direct in deze map staat, of op het hoogste niveau. Zonder deze flag wordt alles weergegeven

Varianten

Elke link is een container met een of meer varianten. Een variant is de content (URL, bestand of tekst) plus een eigen gate (--password, --starts, --expires, --max-openings), een --weight en optionele voorwaarden voor bezoekers (--when). Zonder --variant heeft een link één variant met de naam main, en elk commando hierboven is daar een afkorting voor. Een bezoeker krijgt één variant: de varianten waarvan --when matcht vormen de pool (matcht er geen, dan vormen de onvoorwaardelijke varianten de pool), en daaruit volgt een gewogen keuze. Met sticky toewijzing (standaard) houdt een terugkerende bezoeker dezelfde variant. De gate van de link zelf gaat voor op de gates van varianten. Variantnamen: kleine letters, cijfers, koppeltekens binnenin, 1–40 tekens, uniek per link. Max. 20 varianten.

De kind van een link is bij één variant de soort van die variant, en bij meerdere varianten group. De status van een link is de linkgate als die is ingesteld (paused, scheduled, expired), anders de gezamenlijke status van de varianten, anders mixed. variantStatuses telt {active, paused, expired, scheduled}.

Aanmaken met variantblokken

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> start een variantblok. Flags daarna horen bij die variant tot de volgende --variant: --url|--file|--text, --password, --starts, --expires, --max-openings, --weight <n>, --when <key=v1,v2> (herhaalbaar), --utm-*. Linkflags (--slug --name --tag --domain --preview-* --password --starts --expires --max-openings --sticky --no-sticky --forward-params) komen vóór de eerste --variant.

Variant-subcommando’s

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> accepteert één van --url, --file of --text, plus gateflags, --weight, --when en --utm-*. variants update <id> <name> accepteert --name <new>, content, gateflags, --status active|paused, --weight, --when, --clear-when, --clear-password, --clear-starts, --clear-expires en --clear-max-openings. Een link houdt altijd minstens één variant.

--when-keys

Key JSON-veld Waarden
country countries ISO-2-codes (DE, AT)
device devices mobile tablet desktop
os os windows macos android ios linux other
browser browsers edge chrome firefox safari other
language languages prefix-match (de, en-us)
referrer referrerHosts host-suffix (twitter.com)

Elke ingestelde key moet matchen. --when country=DE,AT --when device=mobile wordt { "countries": ["DE","AT"], "devices": ["mobile"] }.

Regels voor queryparameters

--when accepteert ook param:-regels op de querystring van de bezoeker (lida.sh/promo?src=newsletter). Keys zijn hoofdlettergevoelig, waarden worden exact vergeleken, en je kunt max. 10 regels per variant gebruiken. Komma’s splitsen --when, dus een parameterwaarde kan geen komma bevatten; gebruik | voor lijsten.

Syntaxis JSON-op Matcht als
param:KEY=VALUE equals de waarde precies VALUE is
param:KEY!=VALUE notEquals de waarde afwijkt, of de key ontbreekt
param:KEY~=VALUE includes de waarde VALUE bevat
param:KEY^=VALUE startsWith de waarde begint met VALUE
param:KEY$=VALUE endsWith de waarde eindigt op VALUE
param:KEY=v1|v2 in de waarde in de lijst staat
param:KEY? of param:KEY exists de key aanwezig is
param:!KEY missing de key ontbreekt
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-vorm: "when": { "params": [{ "key": "src", "op": "equals", "value": "newsletter" }] } (value wordt weggelaten bij exists / missing). Parameterwaarden worden gematcht op het moment van openen en nooit opgeslagen in analytics.

Queryparameters doorsturen

--forward-params / --no-forward-params op links create en links update (op linkniveau, standaard uit) voegt de volledige querystring van de bezoeker toe aan URL-varianten: lida.sh/promo?src=nl opent https://example.com/?src=nl. Waarden van de bezoeker overschrijven opgeslagen waarden, ook die van --utm-*. Bestands- en tekstvarianten negeren deze instelling. Dit is routing, geen toegangscontrole: iedereen kan parameters toevoegen. Parameterwaarden worden niet opgeslagen in analytics. links get toont dit als forwardParams.

Sticky en split herstarten

links update <id> --sticky / --no-sticky bepaalt of een terugkerende bezoeker dezelfde variant houdt. links update <id> --restart-split verdeelt de sticky toewijzingen opnieuw. Contentflags op links update werken alleen voor links met één variant; gebruik anders links variants update <id> <name>.

Mappen

Een map is een link die de items toont die je erin zet. Zie Mappen voor hoe de openbare pagina en de toegang werken.

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> stelt de mapnaam in (niet --name) en accepteert --slug, --domain, --password, --starts, --expires, --max-openings, --tag, --preview-* en --in. Je kunt het niet combineren met --url, --file, --text of --variant. links move print {id, folder}. links copy behoudt het toegangsniveau maar krijgt een nieuwe deel-URL; mensen worden niet meegekopieerd. links delete op een map verplaatst de items een niveau omhoog; met --with-contents worden ze ook verwijderd. Rijen van list, get en create bevatten folder (de slug van de map waarin het item staat, of null); maprijen bevatten ook items.

Toegang en delen

Nieuwe links en mappen zijn restricted: hun url is https://linkdash.dev/s/<token>, die alleen jij en de mensen met wie je deelt kunnen openen, mits ingelogd. Met --access link kan iedereen die de URL heeft hem openen. --access public serveert de link op zijn korte URL (lida.sh/<slug> of je eigen domein). Gebruik --access public voor links die je openbaar post. De slug blijft voor elk commando de id, en de korte URL blijft gereserveerd zolang de link niet openbaar is. Zie Delen en toegang voor het volledige model.

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
Commando Print
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 (zonder id) {items: [{id, name?, kind, access, url, people: [{email, accepted, invitedAt}]}], cursor}, meest recent gedeeld eerst
links shared {items: [{_id, _creationTime, kind, title?, status, hasPassword, access, url, itemCount?, sharedBy?, sharedAt}], cursor}, nieuwste eerst
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> (of links update <id> --reset-share-link) {id, access, url}

--role editor maakt iemand editor: die kan het item wijzigen en de statistieken zien, maar niet aan wachtwoorden, slug, domein, toegang of delen komen, en ook niet verwijderen, verplaatsen of kopiëren. Voor een doel met een wachtwoord is eerst links unlock nodig (30 minuten). Editors gebruiken de _id of de deel-URL uit links shared. Al deze commando’s accepteren --domain <host> als de slug vaker voorkomt. url in de output van create, get, list, update, copy en share is de deel-URL, tenzij de link openbaar is; dan is het de korte URL. Rijen bevatten access. Maximaal 200 mensen per item, 50 e-mailadressen per aanroep en 100 uitnodigingsmails per account per dag. De twee lijsten printen één pagina: --limit is 1-100 (standaard 50); geef --cursor van de vorige pagina mee totdat cursor null is. links leave accepteert de _id of url uit links shared; toegang via een bovenliggende gedeelde map blijft bestaan. Delen, delen intrekken, een toegangswijziging en een reset tellen elk als één event; een item verlaten telt niet.

Statistieken

linkdash links stats <id> --last 24h

--last is een tijdsduur (24h, 7d). Standaard 24h. De JSON bevat visits, downloads, plays, visitsInLast, countries, referrers, variants (totalen per variant), visitors (elk met variant) en crawlers ([{crawler, company, category, hits, lastSeen}]: bots en linkpreviews die de link hebben opgehaald; die tellen nooit als bezoek).

CSV

Kolommen: slug,kind,name,variant,url,text,fileName,status,domain,tags,starts,expires,maxOpenings,weight,when,created,folder,access. Eén rij per variant. kind, status, url, text, fileName, weight en when (JSON-string) gelden per variant; de rest geldt per link en wordt herhaald. folder is de slug van de map waarin de link staat. access is restricted, link of public. Geen wachtwoorden, deeltokens of mensen.

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

Import groepeert rijen op slug + domein. De eerste rij maakt de link aan met zijn variant; volgende rijen voegen varianten toe. Bij een bestaande link werkt de eerste rij de linkvelden bij; daarna werkt elke rij de variant met die naam bij als die bestaat, en voegt hem anders toe. Bestandsrijen zonder bytes worden overgeslagen met een foutmelding per rij. Rijen met kind = folder (en een name) maken mappen aan; de kolom folder plaatst elke link in zijn map zodra alle rijen bestaan. Een lege access maakt nieuwe links beperkt en laat bestaande links ongewijzigd.

Voorbeelden

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

Zie ook mappen, delen en toegang, webhooks en eigen domeinen.

Was deze pagina nuttig?