Prejsť na obsah
LinkdashLinkdash
Slovenčina
Esc
↑↓navigácia↵otvoriť⌘Jnáhľad
Na tejto stránke

CLI

Nainštalujte linkdash-cli z npm a potom spustite príkaz `linkdash`. Úspešné príkazy vypisujú JSON na stdout. Nápoveda a chyby sú obyčajný text na stderr.

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

Balík npm sa volá linkdash-cli. Príkaz je linkdash.

Ekvivalent cez HTTP: HTTP API. MCP: MCP. Skill pre agentov: Skill pre agentov. Ceny: Ceny. Čistý markdown: cli.md.

Príznak --json neexistuje. Pri chybách je návratový kód 1.

Autentifikácia

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

Ešte nemáte účet? auth create otvorí https://linkdash.dev/sign-up a potom vás vráti na https://linkdash.dev/device s kódom CLI, aby ste mohli prihlásenie schváliť. Už máte účet? auth login otvorí /device. Bez prehliadača (headless): nastavte LINKDASH_TOKEN na token relácie z auth create alebo auth login. Tokeny si nevymýšľajte.

Súbor relácie: ~/.config/linkdash/config.json (režim 0600).

CLI nedokáže zmeniť e-mail, heslo ani fakturáciu. Pošlite používateľa na nástenku. Kľúče API (HTTP a MCP): Kľúče API.

Príkazy

linkdash <command> [options]
Príkaz Čo robí
auth create Registrácia v prehliadači, potom schválenie zariadenia
auth login Prihlásenie zariadenia v prehliadači
auth logout Zabudne uloženú reláciu
auth whoami JSON prihláseného účtu
links list Vypíše odkazy a priečinky po stránkach (--limit, --cursor)
links get <id> Jeden odkaz
links create --url <url> Krátky odkaz z URL
links create --file <path> Nahrá súbor a vráti odkaz
links create --text <text> Uloží úryvok
links create --folder <name> Vytvorí priečinok
links create --variant <name> … Odkaz s viacerými variantmi (rozdelenie / cielenie)
links update <id> Zmení cieľ, súbor, heslo, expiráciu, doménu, stav, sticky priradenie alebo preposielané parametre
links move <id> --in <folder-id> Presunie odkaz alebo priečinok do priečinka (--root pre najvyššiu úroveň)
links copy <id> Vytvorí kópiu s novým slugom v tom istom priečinku
links delete <id> Odstráni odkaz (položky priečinka sa presunú o úroveň vyššie; --with-contents ich odstráni)
links share <id> --email <email> Zdieľa s ľuďmi podľa e-mailu (--email opakujte; --role editor im umožní položku meniť; každý nový človek dostane e-mail s pozvánkou)
links unshare <id> --email <email> Odoberie niekomu prístup
links shares [id] Kto ho okrem vás môže otvoriť, vrátane prístupu cez nadradený priečinok. Bez id: všetko, k čomu ste pozvali ľudí, po stránkach (--limit, --cursor)
links shared Čo s vami zdieľali iní ľudia, po stránkach (--limit, --cursor)
links leave <_id | share URL> Vzdá sa niečoho, čo s vami niekto zdieľal
links role <id> --email <e> --role viewer|editor Nastaví niekoho, koho ste pozvali, ako čitateľa alebo editora
links unlock <_id | share URL> Zadá heslo zdieľanej položky, aby ste jej cieľ mohli 30 minút vidieť a upravovať
links activity <id> Kto položku zmenil a ako
links reset-link <id> Nová URL na zdieľanie; stará URL linkdash.dev/s/ prestane fungovať
links stats <id> Súčty návštev, stiahnutí a prehratí, aj za jednotlivé varianty, plus crawlery
links export Vypíše všetky odkazy ako CSV (jeden riadok na variant)
links import <file> Importuje riadky s URL a textom z CSV
links variants list <id> Varianty odkazu
links variants add <id> --name <n> Pridá variant
links variants update <id> <name> Zmení variant
links variants remove <id> <name> Odstráni variant
webhooks list Vypíše koncové body webhookov (tajný kľúč je maskovaný)
webhooks get <id> Zobrazí URL jedného webhooku (tajný kľúč je maskovaný)
webhooks create --url <https> Pridá koncový bod HTTPS (tajný kľúč sa zobrazí iba raz)
webhooks rotate <id> Vydá nový podpisový tajný kľúč
webhooks delete <id> Odstráni webhook
domains list Vypíše vlastné názvy hostiteľov
domains add <host> Pridá názov hostiteľa (1 v pláne Free)
domains connect <host> URL na použitie Domain Connect alebo null
domains verify <host> Skontroluje DNS cez Unkey
domains remove <host> Odstráni názov hostiteľa
-h, --help Nápoveda (obyčajný text)
-v, --version Verzia

Ak rovnaký slug existuje na dvoch doménach vlastníka, zadajte --domain.

Príznaky pre vytváranie a úpravu

Slug je id odkazu a zároveň jeho verejná cesta, keď je odkaz verejný. Názov vidíte iba vy. Nové odkazy sú obmedzené (pozrite Prístup a zdieľanie). Príkaz create prijíma práve jedno z týchto: --url, --file alebo --text (z toho sa stane variant main), bloky --variant (pozrite Varianty) alebo --folder <name> (pozrite Priečinky).

Príznak Poznámky
--url <url> Cieľová URL
--file <path> Súbor na nahratie (pri vytvorení), pri úprave nahradí obsah súboru
--text <text> Úryvok
--access <restricted|link|public> Kto ho môže otvoriť. Predvolene restricted. Pozrite Prístup a zdieľanie
--reset-share-link Vydá novú URL na zdieľanie (iba update)
--slug <id> Verejná cesta: a-z0-9 a vnútorné spojovníky, 1–64
--name <label> Súkromný štítok
--tag <tag> Opakovateľný. Malé písmená, bez čiarok. Max. 20
--starts <when> Spustí sa po 7d, 24h, 30m alebo k dátumu ISO
--password <secret> Na otvorenie vyžaduje toto heslo
--expires <when> Prestane sa poskytovať po 7d, 24h, 30m alebo k dátumu ISO
--max-openings <n> Po tomto počte otvorení sa pozastaví. Ak ho vynecháte, počet je neobmedzený
--domain <host> Poskytuje sa na tomto hostiteľovi namiesto lida.sh
--in <folder-id> Vytvorí v tomto priečinku (iba create; --in-domain <host>, ak sa slug priečinka opakuje)
--status <active|paused> Pozastaví alebo obnoví (iba update)
--sticky / --no-sticky Vracajúci sa návštevník dostane ten istý variant (predvolene sticky)
--restart-split Znova premieša sticky priradenia (iba update)
--forward-params / --no-forward-params Pripojí query string návštevníka k URL variantom (predvolene vypnuté). Pozrite Preposielanie parametrov dopytu
--variant <name> Začne blok variantu (iba create). Pozrite Varianty
--weight <n> --when <key=v1,v2> Pre každý variant zvlášť. Pozrite Varianty a Pravidlá pre parametre dopytu
--preview-name <text> Verejný názov v náhľade odkazu
--preview-description <text> Verejný popis v náhľade odkazu
--preview-image <path> Verejný obrázok v náhľade odkazu
--utm-source --utm-medium --utm-campaign --utm-term --utm-content Iba odkazy na URL
--clear-password --clear-expires --clear-starts --clear-tags --clear-preview --clear-name --clear-max-openings Iba update

--status prijíma iba active alebo paused. Stav expired vyplýva z --expires. Stav scheduled vyplýva z --starts. Verejné rozlíšenie vracia až do spustenia not-found. Po dosiahnutí --max-openings sa odkaz pozastaví; ak ho chcete znova poskytovať, zvýšte počet alebo použite --clear-max-openings. Už využité otvorenia zostávajú započítané, kým limit nezmeníte alebo neodstránite.

Slugy na lida.sh sú spoločné pre všetkých. Ak je slovo obsadené, pridajte vlastnú doménu a skúste to znova s --domain. Odkaz na vlastnej doméne sa zároveň nezverejní na lida.sh.

Príznaky pre výpis

Vypíše jednu stránku {items, cursor}: --limit je 1-100 (predvolene 50); zadávajte --cursor s hodnotou cursor z predchádzajúcej stránky, kým nie je null. Stránka môže obsahovať menej položiek než --limit, ak filter niektoré preskočí. --q hľadá celé slová, pričom posledné sa berie ako predpona (laun nájde example.com/launch), a výsledky radí podľa relevancie; --in vypíše jeden priečinok, najprv priečinky; inak sa radí od najnovších.

Príznak Poznámky
--limit <n> Položky na stránku, 1-100 (predvolene 50)
--cursor <c> cursor z predchádzajúcej stránky
--q <text> Hľadá slová v názve, slugu, názvoch a cieľoch variantov, názvoch súborov, texte úryvkov a štítkoch
--tag <tag> Filtruje podľa štítka
--kind <url|file|text|folder|group> Filtruje podľa druhu (group = viacero variantov)
--status <status> active, paused, expired, scheduled alebo mixed
--in <folder-id|root> Iba to, čo je priamo v tomto priečinku alebo na najvyššej úrovni. Bez neho sa vypíše všetko

Varianty

Každý odkaz je kontajner pre jeden alebo viac variantov. Variant tvorí obsah (URL, súbor alebo text) plus jeho vlastné obmedzenia (--password, --starts, --expires, --max-openings), --weight a voliteľné podmienky pre návštevníka (--when). Bez --variant má odkaz jeden variant s názvom main a každý vyššie uvedený príkaz je preň skratkou. Návštevník dostane jeden variant: varianty, ktorých --when sa zhoduje, tvoria výberovú skupinu (ak sa nezhoduje žiadny, tvoria ju varianty bez podmienok), z ktorej sa potom vyberá podľa váhy. Pri sticky priradení (predvolené) dostane vracajúci sa návštevník ten istý variant. Obmedzenia samotného odkazu majú prednosť pred obmedzeniami variantov. Názvy variantov: malé písmená, číslice, vnútorné spojovníky, 1–40 znakov, jedinečné v rámci odkazu. Max. 20 variantov.

Hodnota kind odkazu je pri jednom variante druh tohto variantu a pri viacerých group. Hodnota status odkazu je stav obmedzenia odkazu, ak je nastavené (paused, scheduled, expired), inak spoločný stav variantov, inak mixed. variantStatuses počíta {active, paused, expired, scheduled}.

Vytvorenie s blokmi variantov

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> začína blok variantu. Príznaky za ním patria k tomuto variantu až po ďalší --variant: --url|--file|--text, --password, --starts, --expires, --max-openings, --weight <n>, --when <key=v1,v2> (opakovateľný), --utm-*. Príznaky odkazu (--slug --name --tag --domain --preview-* --password --starts --expires --max-openings --sticky --no-sticky --forward-params) patria pred prvý --variant.

Podpríkazy pre varianty

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> prijíma jedno z --url, --file, --text, plus príznaky obmedzení, --weight, --when, --utm-*. variants update <id> <name> prijíma --name <new>, obsah, príznaky obmedzení, --status active|paused, --weight, --when, --clear-when, --clear-password, --clear-starts, --clear-expires, --clear-max-openings. Odkaz si vždy ponechá aspoň jeden variant.

Kľúče --when

Kľúč Pole JSON Hodnoty
country countries Kódy 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 zhoda predpony (de, en-us)
referrer referrerHosts prípona hostiteľa (twitter.com)

Každý nastavený kľúč sa musí zhodovať. --when country=DE,AT --when device=mobile zodpovedá { "countries": ["DE","AT"], "devices": ["mobile"] }.

Pravidlá pre parametre dopytu

--when prijíma aj pravidlá param: pre query string návštevníka (lida.sh/promo?src=newsletter). Kľúče rozlišujú veľké a malé písmená, hodnoty sa porovnávajú presne, max. 10 pravidiel na variant. Čiarky rozdeľujú --when, takže hodnota parametra nemôže obsahovať čiarku; pre zoznamy použite |.

Syntax op v JSON Zhoduje sa, keď
param:KEY=VALUE equals hodnota je presne VALUE
param:KEY!=VALUE notEquals hodnota sa líši alebo kľúč chýba
param:KEY~=VALUE includes hodnota obsahuje VALUE
param:KEY^=VALUE startsWith hodnota začína na VALUE
param:KEY$=VALUE endsWith hodnota končí na VALUE
param:KEY=v1|v2 in hodnota je jednou zo zoznamu
param:KEY? or param:KEY exists kľúč je prítomný
param:!KEY missing kľúč chýba
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?"

Tvar JSON: "when": { "params": [{ "key": "src", "op": "equals", "value": "newsletter" }] } (pri exists / missing sa value vynecháva). Hodnoty parametrov sa porovnávajú v čase otvorenia a nikdy sa neukladajú do analytiky.

Preposielanie parametrov dopytu

--forward-params / --no-forward-params pri links create a links update (na úrovni odkazu, predvolene vypnuté) pripája celý query string návštevníka k URL variantom: lida.sh/promo?src=nl otvorí https://example.com/?src=nl. Hodnoty od návštevníka prepíšu uložené hodnoty vrátane --utm-*. Varianty so súborom a textom toto nastavenie ignorujú. Ide o smerovanie, nie o riadenie prístupu: parametre môže pridať ktokoľvek. Hodnoty parametrov sa neukladajú do analytiky. links get toto nastavenie zobrazuje ako forwardParams.

Sticky priradenie a reštart rozdelenia

links update <id> --sticky / --no-sticky určuje, či vracajúci sa návštevník dostane ten istý variant. links update <id> --restart-split znova premieša sticky priradenia. Príznaky obsahu pri links update fungujú iba pre odkazy s jedným variantom; inak použite links variants update <id> <name>.

Priečinky

Priečinok je odkaz, ktorý zobrazuje zoznam položiek, ktoré doň vložíte. Ako funguje verejná stránka a prístup, nájdete v časti Priečinky.

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> nastavuje názov priečinka (nie --name) a prijíma --slug, --domain, --password, --starts, --expires, --max-openings, --tag, --preview-* a --in. Nedá sa kombinovať s --url, --file, --text ani --variant. links move vypíše {id, folder}. links copy zachová úroveň prístupu, ale kópia dostane novú URL na zdieľanie; ľudia sa nekopírujú. links delete pri priečinku presunie jeho položky o úroveň vyššie; --with-contents ich tiež odstráni. Riadky z list, get a create obsahujú folder (slug priečinka, v ktorom sa položka nachádza, alebo null); riadky priečinkov obsahujú aj items.

Prístup a zdieľanie

Nové odkazy a priečinky sú restricted: ich url je https://linkdash.dev/s/<token>, ktorú môžete otvoriť iba vy a ľudia, s ktorými ju zdieľate, a to po prihlásení. --access link sprístupní túto URL každému, kto ju má. --access public poskytuje odkaz na jeho krátkej URL (lida.sh/<slug> alebo na vašej vlastnej doméne). Pre odkazy, ktoré zverejňujete, použite --access public. Slug zostáva id pre všetky príkazy a jeho krátka URL zostáva rezervovaná, kým odkaz nie je verejný. Celý model nájdete v časti Zdieľanie a prístup.

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
Príkaz Vypíše
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 (bez id) {items: [{id, name?, kind, access, url, people: [{email, accepted, invitedAt}]}], cursor}, od naposledy zdieľaných
links shared {items: [{_id, _creationTime, kind, title?, status, hasPassword, access, url, itemCount?, sharedBy?, sharedAt}], cursor}, od najnovších
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> (alebo links update <id> --reset-share-link) {id, access, url}

--role editor urobí z niekoho editora: môže meniť položku a vidieť jej štatistiky, ale nie heslá, slug, doménu, prístup ani zdieľanie, položku nemôže odstrániť, presunúť ani kopírovať a cieľ chránený heslom musí najprv odomknúť cez links unlock (na 30 minút). Editori používajú _id alebo URL na zdieľanie z links shared. Všetky príkazy prijímajú --domain <host>, ak sa slug opakuje. url vo výstupe create, get, list, update, copy a share je URL na zdieľanie, pokiaľ odkaz nie je verejný; vtedy je to krátka URL. Riadky obsahujú access. Najviac 200 ľudí na položku, 50 e-mailov na jedno volanie, 100 e-mailov s pozvánkou na účet za deň. Oba zoznamy vypisujú jednu stránku: --limit je 1-100 (predvolene 50); zadávajte --cursor z predchádzajúcej stránky, kým cursor nie je null. links leave prijíma _id alebo url z links shared; prístup cez zdieľaný nadradený priečinok zostáva zachovaný. Zdieľanie, zrušenie zdieľania, zmena prístupu a reset sa rátajú každé ako jedna udalosť; opustenie nie.

Štatistiky

linkdash links stats <id> --last 24h

--last je trvanie (24h, 7d). Predvolene 24h. JSON obsahuje visits, downloads, plays, visitsInLast, countries, referrers, variants (súčty za jednotlivé varianty), visitors (každý s variant) a crawlers ([{crawler, company, category, hits, lastSeen}]: boty a náhľady odkazov, ktoré odkaz načítali; nikdy sa nerátajú ako návštevy).

CSV

Stĺpce: slug,kind,name,variant,url,text,fileName,status,domain,tags,starts,expires,maxOpenings,weight,when,created,folder,access. Jeden riadok na variant. kind, status, url, text, fileName, weight a when (reťazec JSON) sa viažu na variant; ostatné stĺpce sa viažu na odkaz a opakujú sa. folder je slug priečinka, v ktorom sa odkaz nachádza. access je restricted, link alebo public. Bez hesiel, tokenov na zdieľanie a ľudí.

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

Import zoskupuje riadky podľa slugu a domény. Prvý riadok vytvorí odkaz s jeho variantom; ďalšie riadky pridajú varianty. Pri existujúcom odkaze prvý riadok aktualizuje polia odkazu a potom každý riadok aktualizuje variant podľa názvu, ak existuje, inak ho pridá. Riadky so súbormi bez obsahu sa preskočia s chybou pre daný riadok. Riadky s kind = folder (s hodnotou name) vytvoria priečinky; stĺpec folder umiestni každý odkaz do jeho priečinka, keď už existujú všetky riadky. Prázdne access nastaví nové odkazy ako obmedzené a existujúce odkazy ponechá bez zmeny.

Príklady

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

Pozrite aj priečinky, zdieľanie a prístup, webhooky a vlastné domény.

Bola táto stránka užitočná?