Přejít k obsahu
LinkdashLinkdash
Čeština
Esc
↑↓navigace↵otevřít⌘Jnáhled
Na této stránce

CLI

Nainstalujte linkdash-cli z npm a poté spusťte příkaz `linkdash`. Úspěšné příkazy vypisují JSON na stdout. Nápověda a chyby se vypisují jako prostý text na stderr.

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

Balíček npm se jmenuje linkdash-cli. Příkaz se jmenuje linkdash.

Ekvivalent přes HTTP: HTTP API. MCP: MCP. Skill pro agenty: Skill pro agenty. Ceník: Ceník. Čistý markdown: cli.md.

Příznak --json neexistuje. Při chybě je návratový kód 1.

Ověření

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

Ještě nemáte účet? auth create otevře https://linkdash.dev/sign-up a poté se vrátí na https://linkdash.dev/device s kódem z CLI, abyste mohli přístup schválit. Účet už máte? auth login otevře /device. Bez prohlížeče: nastavte LINKDASH_TOKEN na token relace z auth create nebo auth login. Tokeny si nevymýšlejte.

Soubor relace: ~/.config/linkdash/config.json (režim 0600).

CLI nemůže měnit e-mail, heslo ani fakturaci. Pošlete uživatele na nástěnku. Klíče API (HTTP a MCP): Klíče API.

Příkazy

linkdash <command> [options]
Příkaz Co dělá
auth create Registrace v prohlížeči a poté schválení zařízení
auth login Přihlášení zařízení přes prohlížeč
auth logout Zapomene uloženou relaci
auth whoami JSON přihlášeného účtu
links list Vypíše odkazy a složky po stránkách (--limit, --cursor)
links get <id> Jeden odkaz
links create --url <url> Krátký odkaz z URL
links create --file <path> Nahraje soubor a vrátí odkaz
links create --text <text> Uloží úryvek textu
links create --folder <name> Vytvoří složku
links create --variant <name> … Odkaz s několika variantami (rozdělení / cílení)
links update <id> Změní cíl, soubor, heslo, expiraci, doménu, stav, sticky nebo předávané parametry
links move <id> --in <folder-id> Přesune odkaz nebo složku do složky (--root pro nejvyšší úroveň)
links copy <id> Vytvoří kopii s novým slugem ve stejné složce
links delete <id> Smaže odkaz (položky složky se přesunou o úroveň výš; --with-contents je smaže)
links share <id> --email <email> Sdílí s lidmi podle e-mailu (opakujte --email; --role editor jim umožní položku měnit; každý nový člověk dostane e-mail s pozvánkou)
links unshare <id> --email <email> Odebere někomu přístup
links shares [id] Kdo kromě vás může položku otevřít, včetně přístupu přes nadřazenou složku. Bez id: vše, k čemu jste lidi pozvali, po stránkách (--limit, --cursor)
links shared Co s vámi sdíleli ostatní, po stránkách (--limit, --cursor)
links leave <_id | share URL> Vzdá se položky, která je s vámi sdílená
links role <id> --email <e> --role viewer|editor Nastaví pozvanému člověku roli čtenáře nebo editora
links unlock <_id | share URL> Zadá heslo sdílené položky, abyste na 30 minut viděli a mohli upravit její cíl
links activity <id> Kdo položku změnil a jak
links reset-link <id> Nová URL pro sdílení; stará URL linkdash.dev/s/ přestane fungovat
links stats <id> Celkové počty návštěv, stažení a přehrání, také po variantách, plus crawlery
links export Vypíše všechny odkazy jako CSV (jeden řádek na variantu)
links import <file> Importuje řádky s URL a textem z CSV
links variants list <id> Varianty odkazu
links variants add <id> --name <n> Přidá variantu
links variants update <id> <name> Změní variantu
links variants remove <id> <name> Odebere variantu
webhooks list Vypíše koncové body webhooků (tajný klíč skrytý)
webhooks get <id> Zobrazí URL jednoho webhooku (tajný klíč skrytý)
webhooks create --url <https> Přidá koncový bod HTTPS (tajný klíč se zobrazí jednou)
webhooks rotate <id> Vydá nový podpisový tajný klíč
webhooks delete <id> Odebere webhook
domains list Vypíše vlastní názvy hostitelů
domains add <host> Přidá název hostitele (1 v tarifu Free)
domains connect <host> URL pro použití Domain Connect, nebo null
domains verify <host> Zkontroluje DNS pomocí Unkey
domains remove <host> Odebere název hostitele
-h, --help Nápověda (prostý text)
-v, --version Verze

Pokud stejný slug existuje na dvou doménách vlastníka, zadejte --domain.

Příznaky pro vytvoření a úpravu

Slug je id odkazu a u veřejného odkazu také jeho veřejná cesta. Název vidíte jen vy. Nové odkazy jsou omezené (viz Přístup a sdílení). Vytvoření přijímá právě jedno z --url, --file nebo --text (z toho se stane varianta main), bloky --variant (viz Varianty), nebo --folder <name> (viz Složky).

Příznak Poznámky
--url <url> Cílová URL
--file <path> Soubor k nahrání (při vytvoření, nebo nahrazení obsahu při úpravě)
--text <text> Úryvek textu
--access <restricted|link|public> Kdo může položku otevřít. Výchozí restricted. Viz Přístup a sdílení
--reset-share-link Vydá novou URL pro sdílení (jen při úpravě)
--slug <id> Veřejná cesta: a-z0-9 a vnitřní pomlčky, 1–64
--name <label> Soukromý popisek
--tag <tag> Lze opakovat. Malá písmena, bez čárek. Max. 20
--starts <when> Zveřejní po 7d, 24h, 30m nebo k datu ISO
--password <secret> K otevření vyžaduje toto heslo
--expires <when> Přestane obsluhovat po 7d, 24h, 30m nebo k datu ISO
--max-openings <n> Pozastaví po tomto počtu otevření. Vynechte pro neomezený počet
--domain <host> Obsluhuje na tomto hostiteli místo lida.sh
--in <folder-id> Vytvoří uvnitř této složky (jen při vytvoření; --in-domain <host>, pokud se slug složky opakuje)
--status <active|paused> Pozastaví nebo obnoví (jen při úpravě)
--sticky / --no-sticky Vracející se návštěvník dostane stejnou variantu (výchozí sticky)
--restart-split Znovu zamíchá sticky přiřazení (jen při úpravě)
--forward-params / --no-forward-params Připojí query string návštěvníka k URL variantám (výchozí vypnuto). Viz Předávání parametrů dotazu
--variant <name> Zahájí blok varianty (jen při vytvoření). Viz Varianty
--weight <n> --when <key=v1,v2> Pro každou variantu. Viz Varianty a Pravidla pro parametry dotazu
--preview-name <text> Veřejný název v náhledu odkazu
--preview-description <text> Veřejný popis v náhledu odkazu
--preview-image <path> Veřejný obrázek v náhledu odkazu
--utm-source --utm-medium --utm-campaign --utm-term --utm-content Jen pro URL odkazy
--clear-password --clear-expires --clear-starts --clear-tags --clear-preview --clear-name --clear-max-openings Jen při úpravě

--status přijímá pouze active nebo paused. Stav vypršení plyne z --expires. Stav naplánování plyne z --starts. Veřejné rozlišení vrací do začátku „nenalezeno“. Po dosažení --max-openings se odkaz pozastaví; chcete-li jej znovu obsluhovat, zvyšte číslo nebo použijte --clear-max-openings. Již využitá otevření zůstávají započítaná, dokud limit nezměníte nebo neodstraníte.

Slugy na lida.sh jsou sdílené. Pokud je slovo obsazené, přidejte vlastní doménu a zkuste to znovu s --domain. Odkaz na vlastní doméně se nepublikuje zároveň na lida.sh.

Příznaky pro výpis

Vypíše jednu stránku, {items, cursor}: --limit je 1–100 (výchozí 50); předávejte --cursor s hodnotou cursor z předchozí stránky, dokud není null. Stránka může obsahovat méně položek než --limit, pokud filtr některé přeskočí. --q hledá celá slova, přičemž poslední slovo se bere jako prefix (laun najde example.com/launch), řazeno podle relevance; --in vypíše jednu složku, složky jako první; jinak od nejnovějších.

Příznak Poznámky
--limit <n> Položek na stránku, 1–100 (výchozí 50)
--cursor <c> Hodnota cursor z předchozí stránky
--q <text> Hledá slova v názvu, slugu, názvech a cílech variant, názvech souborů, textu úryvků a štítcích
--tag <tag> Filtruje podle štítku
--kind <url|file|text|folder|group> Filtruje podle druhu (group = několik variant)
--status <status> active, paused, expired, scheduled nebo mixed
--in <folder-id|root> Jen to, co je přímo v této složce, nebo na nejvyšší úrovni. Bez něj se vypíše vše

Varianty

Každý odkaz je kontejner jedné nebo více variant. Varianta je obsah (URL, soubor nebo text) plus vlastní brána (--password, --starts, --expires, --max-openings), váha --weight a volitelné podmínky pro návštěvníka (--when). Bez --variant má odkaz jednu variantu s názvem main a každý výše uvedený příkaz je pro ni zkratkou. Návštěvník dostane jednu variantu: varianty, jejichž --when odpovídá, tvoří množinu kandidátů (pokud žádná neodpovídá, použijí se varianty bez podmínek), a z ní se provede vážený výběr. Při sticky přiřazení (výchozí) dostane vracející se návštěvník stejnou variantu. Brána samotného odkazu má přednost před branami variant. Názvy variant: malá písmena, číslice, vnitřní pomlčky, 1–40 znaků, jedinečné v rámci odkazu. Max. 20 variant.

kind odkazu je u jedné varianty druh této varianty a u více variant group. status odkazu je brána odkazu, pokud je nastavená (paused, scheduled, expired), jinak společný stav variant, jinak mixed. variantStatuses počítá {active, paused, expired, scheduled}.

Vytvoření s bloky variant

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> zahájí blok varianty. Příznaky za ním patří k této variantě až do dalšího --variant: --url|--file|--text, --password, --starts, --expires, --max-openings, --weight <n>, --when <key=v1,v2> (lze opakovat), --utm-*. Příznaky odkazu (--slug --name --tag --domain --preview-* --password --starts --expires --max-openings --sticky --no-sticky --forward-params) patří před první --variant.

Podpříkazy variant

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> přijímá jedno z --url, --file, --text, plus příznaky brány, --weight, --when, --utm-*. variants update <id> <name> přijímá --name <new>, obsah, příznaky brány, --status active|paused, --weight, --when, --clear-when, --clear-password, --clear-starts, --clear-expires, --clear-max-openings. Odkaz si vždy ponechá alespoň jednu variantu.

Klíče --when

Klíč 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 shoda prefixu (de, en-us)
referrer referrerHosts přípona hostitele (twitter.com)

Každý nastavený klíč musí odpovídat. --when country=DE,AT --when device=mobile odpovídá { "countries": ["DE","AT"], "devices": ["mobile"] }.

Pravidla pro parametry dotazu

--when přijímá také pravidla param: pro query string návštěvníka (lida.sh/promo?src=newsletter). Klíče rozlišují velikost písmen, hodnoty se porovnávají přesně, max. 10 pravidel na variantu. Čárky rozdělují --when, takže hodnota parametru nemůže obsahovat čárku; pro seznamy použijte |.

Syntaxe JSON op Odpovídá, když
param:KEY=VALUE equals hodnota je přesně VALUE
param:KEY!=VALUE notEquals hodnota se liší, nebo klíč chybí
param:KEY~=VALUE includes hodnota obsahuje VALUE
param:KEY^=VALUE startsWith hodnota začíná na VALUE
param:KEY$=VALUE endsWith hodnota končí na VALUE
param:KEY=v1|v2 in hodnota je jednou z položek seznamu
param:KEY? nebo param:KEY exists klíč je přítomen
param:!KEY missing klíč chybí
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" }] } (value se u exists / missing vynechává). Hodnoty parametrů se porovnávají v okamžiku otevření a nikdy se neukládají do analytiky.

Předávání parametrů dotazu

--forward-params / --no-forward-params u links create a links update (na úrovni odkazu, ve výchozím stavu vypnuto) připojí celý query string návštěvníka k URL variantám: lida.sh/promo?src=nl otevře https://example.com/?src=nl. Hodnoty návštěvníka přepisují uložené hodnoty, včetně --utm-*. Varianty se souborem a textem to ignorují. Jde o směrování, nikoli o řízení přístupu: parametry může přidat kdokoli. Hodnoty parametrů se neukládají do analytiky. links get to zobrazuje jako forwardParams.

Sticky a nové rozdělení

links update <id> --sticky / --no-sticky nastavuje, zda vracející se návštěvník dostane stejnou variantu. links update <id> --restart-split znovu zamíchá sticky přiřazení. Příznaky obsahu u links update fungují jen u odkazů s jedinou variantou; jinak použijte links variants update <id> <name>.

Složky

Složka je odkaz, který vypisuje položky, které do ní vložíte. Jak funguje veřejná stránka a přístup, najdete v části Složky.

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ázev složky (ne --name) a přijímá --slug, --domain, --password, --starts, --expires, --max-openings, --tag, --preview-* a --in. Nelze jej kombinovat s --url, --file, --text ani --variant. links move vypíše {id, folder}. links copy zachová úroveň přístupu, ale dostane novou URL pro sdílení; lidé se nekopírují. links delete u složky přesune její položky o úroveň výš; --with-contents je smaže také. Řádky výpisu, získání a vytvoření obsahují folder (slug nadřazené složky, nebo null); řádky složek obsahují také items.

Přístup a sdílení

Nové odkazy a složky jsou restricted: jejich url je https://linkdash.dev/s/<token>, kterou můžete po přihlášení otevřít jen vy a lidé, se kterými ji sdílíte. --access link zpřístupní tuto URL každému, kdo ji má. --access public obsluhuje odkaz na jeho krátké URL (lida.sh/<slug> nebo vaše vlastní doména). Pro odkazy, které zveřejňujete, použijte --access public. Slug zůstává id pro všechny příkazy a jeho krátká URL zůstává rezervovaná, dokud odkaz není veřejný. Úplný model najdete v části Sdílení a pří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
Pří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}, naposledy sdílené jako první
links shared {items: [{_id, _creationTime, kind, title?, status, hasPassword, access, url, itemCount?, sharedBy?, sharedAt}], cursor}, od nejnovější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> (nebo links update <id> --reset-share-link) {id, access, url}

--role editor udělá z člověka editora: může položku měnit a vidět její statistiky, ale ne hesla, slug, doménu, přístup, sdílení, mazání, přesun ani kopírování, a cíl chráněný heslem musí nejprve odemknout pomocí links unlock (30 minut). Editoři používají _id nebo URL pro sdílení z links shared. Všechny příkazy přijímají --domain <host>, pokud se slug opakuje. url ve výstupu create, get, list, update, copy a share je URL pro sdílení, pokud odkaz není veřejný, jinak krátká URL; řádky obsahují access. Až 200 lidí na položku, 50 e-mailů na volání, 100 e-mailů s pozvánkou na účet za den. Oba seznamy vypisují jednu stránku: --limit je 1–100 (výchozí 50); předávejte --cursor z předchozí stránky, dokud cursor není null. links leave přijímá _id nebo url z links shared; přístup přes nadřazenou sdílenou složku zůstává. Sdílení, zrušení sdílení, změna přístupu a reset se každý počítají jako jedna událost; opuštění ne.

Statistiky

linkdash links stats <id> --last 24h

--last je doba trvání (24h, 7d). Výchozí 24h. JSON obsahuje visits, downloads, plays, visitsInLast, countries, referrers, variants (celkové počty po variantách), visitors (každý s variant) a crawlers ([{crawler, company, category, hits, lastSeen}]: boti a náhledy odkazů, které odkaz načetly; nikdy se nepočítají jako návštěvy).

CSV

Sloupce: slug,kind,name,variant,url,text,fileName,status,domain,tags,starts,expires,maxOpenings,weight,when,created,folder,access. Jeden řádek na variantu. kind, status, url, text, fileName, weight a when (řetězec JSON) se vztahují k variantě; ostatní se vztahují k odkazu a opakují se. folder je slug složky, ve které odkaz je. access je restricted, link nebo public. Bez hesel, tokenů pro sdílení a lidí.

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

Import seskupuje řádky podle slugu + domény. První řádek vytvoří odkaz s jeho variantou; další řádky přidávají varianty. U existujícího odkazu první řádek aktualizuje pole odkazu a poté každý řádek aktualizuje variantu podle názvu, pokud existuje, jinak ji přidá. Řádky se soubory bez obsahu se přeskočí s chybou pro daný řádek. Řádky s kind = folder (s name) vytvoří složky; sloupec folder umístí každý odkaz do jeho složky poté, co existují všechny řádky. Prázdný access nastaví nové odkazy jako omezené a existující odkazy ponechá beze změny.

Pří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

Viz také složky, sdílení a přístup, webhooky a vlastní domény.

Byla tato stránka užitečná?