CLI
Namestite linkdash-cli iz npm, nato zaženite ukaz `linkdash`. Uspešni ukazi izpišejo JSON na stdout. Pomoč in napake so navadno besedilo na stderr.
npm i -g linkdash-cli
# or: pnpm add -g linkdash-cli / bun add -g linkdash-cli / npx linkdash-cli@latest
Paket npm je linkdash-cli. Ukaz je linkdash.
Enakovreden HTTP: HTTP API. MCP: MCP. Veščina za agente: Veščina za agente. Cene: Cene. Navaden markdown: cli.md.
Zastavice --json ni. Ob napakah je izhodna koda 1.
Preverjanje pristnosti
linkdash auth create
linkdash auth login
linkdash auth whoami
linkdash auth logout
Še nimate računa? auth create odpre https://linkdash.dev/sign-up, nato pa vas vrne na https://linkdash.dev/device s kodo CLI, da lahko odobrite dostop. Račun že imate? auth login odpre /device. Brez brskalnika: v LINKDASH_TOKEN nastavite sejni žeton iz auth create ali auth login. Žetonov si ne izmišljujte.
Datoteka seje: ~/.config/linkdash/config.json (način 0600).
CLI ne more spremeniti e-poštnega naslova, gesla ali obračunavanja. Uporabnika napotite na nadzorno ploščo. Ključi API (HTTP in MCP): Ključi API.
Ukazi
linkdash <command> [options]
| Ukaz | Kaj naredi |
|---|---|
auth create |
Registracija v brskalniku, nato odobritev naprave |
auth login |
Prijava naprave v brskalniku |
auth logout |
Pozabi shranjeno sejo |
auth whoami |
JSON prijavljenega računa |
links list |
Izpiše povezave in mape, po eno stran naenkrat (--limit, --cursor) |
links get <id> |
Ena povezava |
links create --url <url> |
Kratka povezava iz URL-ja |
links create --file <path> |
Naloži datoteko in vrne povezavo |
links create --text <text> |
Shrani izsek |
links create --folder <name> |
Ustvari mapo |
links create --variant <name> … |
Povezava z več različicami (razdelitev / ciljanje) |
links update <id> |
Spremeni cilj, datoteko, geslo, potek, domeno, stanje, lepljivost ali posredovane parametre |
links move <id> --in <folder-id> |
Premakne povezavo ali mapo v mapo (--root za najvišjo raven) |
links copy <id> |
Naredi kopijo z novim slugom v isti mapi |
links delete <id> |
Izbriše povezavo (elementi mape se premaknejo raven višje; --with-contents jih izbriše) |
links share <id> --email <email> |
Deli z osebami prek e-pošte (ponovite --email; --role editor jim omogoči spreminjanje; vsaka nova oseba prejme e-poštno povabilo) |
links unshare <id> --email <email> |
Odstrani dostop osebe |
links shares [id] |
Kdo jo lahko odpre poleg vas, tudi prek nadrejene mape. Brez id: vse, kamor ste povabili osebe, po eno stran naenkrat (--limit, --cursor) |
links shared |
Kar so drugi delili z vami, po eno stran naenkrat (--limit, --cursor) |
links leave <_id | share URL> |
Odpove se nečemu, kar je bilo deljeno z vami |
links role <id> --email <e> --role viewer|editor |
Osebo, ki ste jo povabili, nastavi kot gledalca ali urednika |
links unlock <_id | share URL> |
Vnese geslo deljenega elementa, da lahko 30 minut vidite in urejate njegov cilj |
links activity <id> |
Kdo je spremenil element in kako |
links reset-link <id> |
Nov URL za deljenje; stari URL linkdash.dev/s/ preneha delovati |
links stats <id> |
Skupno število obiskov, prenosov in predvajanj, tudi po različicah, ter pajki |
links export |
Izpiše vse povezave kot CSV (ena vrstica na različico) |
links import <file> |
Uvozi vrstice z URL-ji in besedilom iz CSV |
links variants list <id> |
Različice povezave |
links variants add <id> --name <n> |
Doda različico |
links variants update <id> <name> |
Spremeni različico |
links variants remove <id> <name> |
Odstrani različico |
webhooks list |
Izpiše končne točke webhookov (skrivnost je zakrita) |
webhooks get <id> |
Prikaže URL enega webhooka (skrivnost je zakrita) |
webhooks create --url <https> |
Doda končno točko HTTPS (skrivnost je prikazana samo enkrat) |
webhooks rotate <id> |
Izda novo podpisno skrivnost |
webhooks delete <id> |
Odstrani webhook |
domains list |
Izpiše gostiteljska imena po meri |
domains add <host> |
Doda gostiteljsko ime (1 v paketu Free) |
domains connect <host> |
URL za uveljavitev Domain Connect ali null |
domains verify <host> |
Preveri DNS z Unkey |
domains remove <host> |
Odstrani gostiteljsko ime |
-h, --help |
Pomoč (navadno besedilo) |
-v, --version |
Različica |
Če isti slug obstaja na dveh domenah lastnika, podajte --domain.
Zastavice za ustvarjanje in posodabljanje
Slug je id povezave, ko je povezava javna, pa tudi njena javna pot. Ime je vidno samo vam. Nove povezave so omejene (glejte Dostop in deljenje). Ukaz create sprejme natanko eno od naslednjega: --url, --file ali --text (to postane različica main), bloke --variant (glejte Različice) ali --folder <name> (glejte Mape).
| Zastavica | Opombe |
|---|---|
--url <url> |
Ciljni URL |
--file <path> |
Datoteka za nalaganje (pri ustvarjanju ali za zamenjavo vsebine pri posodabljanju) |
--text <text> |
Izsek |
--access <restricted|link|public> |
Kdo jo lahko odpre. Privzeto restricted. Glejte Dostop in deljenje |
--reset-share-link |
Izda nov URL za deljenje (samo pri posodabljanju) |
--slug <id> |
Javna pot: a-z0-9 in notranji vezaji, 1–64 znakov |
--name <label> |
Zasebna oznaka |
--tag <tag> |
Ponovljivo. Male črke, brez vejic. Največ 20 |
--starts <when> |
Aktivira se po 7d, 24h, 30m ali na datum ISO |
--password <secret> |
Za odpiranje zahteva to geslo |
--expires <when> |
Preneha s strežbo po 7d, 24h, 30m ali na datum ISO |
--max-openings <n> |
Zaustavi se po tolikšnem številu odpiranj. Izpustite za neomejeno |
--domain <host> |
Streže na tem gostitelju namesto na lida.sh |
--in <folder-id> |
Ustvari v tej mapi (samo pri ustvarjanju; --in-domain <host>, če se slug mape ponavlja) |
--status <active|paused> |
Zaustavi ali nadaljuje (samo pri posodabljanju) |
--sticky / --no-sticky |
Obiskovalec, ki se vrne, obdrži isto različico (privzeto lepljivo) |
--restart-split |
Na novo premeša lepljive dodelitve (samo pri posodabljanju) |
--forward-params / --no-forward-params |
Različicam URL doda poizvedbeni niz obiskovalca (privzeto izklopljeno). Glejte Posredovanje poizvedbenih parametrov |
--variant <name> |
Začne blok različice (samo pri ustvarjanju). Glejte Različice |
--weight <n> --when <key=v1,v2> |
Za posamezno različico. Glejte Različice in Pravila poizvedbenih parametrov |
--preview-name <text> |
Javno ime predogleda |
--preview-description <text> |
Javni opis predogleda |
--preview-image <path> |
Javna slika predogleda |
--utm-source --utm-medium --utm-campaign --utm-term --utm-content |
Samo za povezave URL |
--clear-password --clear-expires --clear-starts --clear-tags --clear-preview --clear-name --clear-max-openings |
Samo pri posodabljanju |
--status sprejme samo active ali paused. Stanje »poteklo« izhaja iz --expires. Stanje »načrtovano« izhaja iz --starts. Javno razreševanje do začetka vrača »ni najdeno«. Ko je dosežena vrednost --max-openings, se povezava zaustavi; za ponovno strežbo povečajte število ali uporabite --clear-max-openings. Že porabljena odpiranja ostanejo šteta, dokler omejitve ne spremenite ali odstranite.
Slugi na lida.sh so skupni. Če je beseda zasedena, dodajte domeno po meri in poskusite znova z --domain. Povezava na domeni z blagovno znamko ni hkrati objavljena tudi na lida.sh.
Zastavice za izpis seznama
Izpiše eno stran, {items, cursor}: --limit je 1-100 (privzeto 50); --cursor podajajte z vrednostjo cursor s prejšnje strani, dokler ta ni null. Stran lahko vsebuje manj elementov, kot določa --limit, če filter nekatere preskoči. --q se ujema s celimi besedami, pri čemer zadnja velja kot predpona (laun najde example.com/launch), rezultati pa so razvrščeni po ustreznosti; --in izpiše eno mapo, najprej mape; sicer so najnovejši prvi.
| Zastavica | Opombe |
|---|---|
--limit <n> |
Število elementov na stran, 1-100 (privzeto 50) |
--cursor <c> |
Vrednost cursor s prejšnje strani |
--q <text> |
Išče besede v imenu, slugu, imenih in ciljih različic, imenih datotek, besedilu izsekov in oznakah |
--tag <tag> |
Filtrira po oznaki |
--kind <url|file|text|folder|group> |
Filtrira po vrsti (group = več različic) |
--status <status> |
active, paused, expired, scheduled ali mixed |
--in <folder-id|root> |
Samo tisto, kar je neposredno v tej mapi ali na najvišji ravni. Brez te zastavice je izpisano vse |
Različice
Vsaka povezava je vsebnik ene ali več različic. Različica je vsebina (URL, datoteka ali besedilo) skupaj z lastnimi omejitvami dostopa (--password, --starts, --expires, --max-openings), utežjo --weight in neobveznimi pogoji za obiskovalce (--when). Brez --variant ima povezava eno različico z imenom main, vsi zgornji ukazi pa so okrajšava zanjo. Obiskovalec dobi eno različico: različice, katerih --when se ujema, tvorijo nabor (če se ne ujema nobena, ga tvorijo brezpogojne različice), nato sledi utežena izbira. Z lepljivo dodelitvijo (privzeto) obiskovalec, ki se vrne, obdrži isto različico. Omejitve dostopa povezave imajo prednost pred omejitvami različic. Imena različic: male črke, števke, notranji vezaji, 1–40 znakov, edinstvena znotraj povezave. Največ 20 različic.
Vrednost kind povezave je pri eni različici vrsta te različice, pri več različicah pa group. Vrednost status povezave je stanje omejitve povezave, če je nastavljeno (paused, scheduled, expired), sicer skupno stanje različic, sicer mixed. variantStatuses šteje {active, paused, expired, scheduled}.
Ustvarjanje z bloki različic
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čne blok različice. Zastavice za njo pripadajo tej različici do naslednje --variant: --url|--file|--text, --password, --starts, --expires, --max-openings, --weight <n>, --when <key=v1,v2> (ponovljivo), --utm-*. Zastavice povezave (--slug --name --tag --domain --preview-* --password --starts --expires --max-openings --sticky --no-sticky --forward-params) navedite pred prvo --variant.
Podukazi za različice
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> sprejme eno od --url, --file, --text ter zastavice omejitev dostopa, --weight, --when, --utm-*. variants update <id> <name> sprejme --name <new>, vsebino, zastavice omejitev dostopa, --status active|paused, --weight, --when, --clear-when, --clear-password, --clear-starts, --clear-expires, --clear-max-openings. Povezava ima vedno vsaj eno različico.
Ključi --when
| Ključ | Polje JSON | Vrednosti |
|---|---|---|
country |
countries |
Kode 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 |
ujemanje predpone (de, en-us) |
referrer |
referrerHosts |
pripona gostitelja (twitter.com) |
Ujemati se mora vsak nastavljeni ključ. --when country=DE,AT --when device=mobile je { "countries": ["DE","AT"], "devices": ["mobile"] }.
Pravila poizvedbenih parametrov
--when sprejme tudi pravila param: za poizvedbeni niz obiskovalca (lida.sh/promo?src=newsletter). Ključi razlikujejo med velikimi in malimi črkami, vrednosti se primerjajo natančno, dovoljenih je največ 10 pravil na različico. Vejice ločujejo --when, zato vrednost parametra ne sme vsebovati vejice; za sezname uporabite |.
| Sintaksa | JSON op |
Ujema se, ko |
|---|---|---|
param:KEY=VALUE |
equals |
je vrednost natanko VALUE |
param:KEY!=VALUE |
notEquals |
se vrednost razlikuje ali ključ manjka |
param:KEY~=VALUE |
includes |
vrednost vsebuje VALUE |
param:KEY^=VALUE |
startsWith |
se vrednost začne z VALUE |
param:KEY$=VALUE |
endsWith |
se vrednost konča z VALUE |
param:KEY=v1|v2 |
in |
je vrednost ena od vrednosti s seznama |
param:KEY? ali param:KEY |
exists |
je ključ prisoten |
param:!KEY |
missing |
ključ manjka |
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?"
Oblika JSON: "when": { "params": [{ "key": "src", "op": "equals", "value": "newsletter" }] } (value se pri exists / missing izpusti). Vrednosti parametrov se preverijo ob odpiranju in se nikoli ne shranijo v analitiko.
Posredovanje poizvedbenih parametrov
--forward-params / --no-forward-params pri links create in links update (na ravni povezave, privzeto izklopljeno) različicam URL doda celoten poizvedbeni niz obiskovalca: lida.sh/promo?src=nl odpre https://example.com/?src=nl. Vrednosti obiskovalca preglasijo shranjene, vključno z --utm-*. Različice z datoteko in besedilom to nastavitev prezrejo. To je usmerjanje, ne nadzor dostopa: parametre lahko doda kdorkoli. Vrednosti parametrov se ne shranijo v analitiko. links get to prikaže kot forwardParams.
Lepljivost in ponovni zagon razdelitve
links update <id> --sticky / --no-sticky določa, ali obiskovalec, ki se vrne, obdrži isto različico. links update <id> --restart-split na novo premeša lepljive dodelitve. Zastavice vsebine pri links update delujejo samo za povezave z eno različico; sicer uporabite links variants update <id> <name>.
Mape
Mapa je povezava, ki navaja elemente, ki ste jih dali vanjo. Za delovanje javne strani in dostopa glejte Mape.
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> nastavi ime mape (ne --name) in sprejme --slug, --domain, --password, --starts, --expires, --max-openings, --tag, --preview-* in --in. Ni je mogoče kombinirati z --url, --file, --text ali --variant. links move izpiše {id, folder}. links copy ohrani raven dostopa, vendar kopija dobi nov URL za deljenje; osebe se ne kopirajo. links delete za mapo premakne njene elemente raven višje; --with-contents jih prav tako izbriše. Vrstice izpisov list, get in create vsebujejo folder (slug mape, ki vsebuje element, ali null); vrstice map vsebujejo tudi items.
Dostop in deljenje
Nove povezave in mape so restricted: njihov url je https://linkdash.dev/s/<token>, ki ga lahko odprete samo vi in osebe, s katerimi ga delite, ko so prijavljene. --access link ta URL odpre vsakomur, ki ga ima. --access public streže povezavo na njenem kratkem URL-ju (lida.sh/<slug> ali vaša domena po meri). --access public uporabite za povezave, ki jih objavljate javno. Slug ostane id za vse ukaze, njegov kratki URL pa ostane rezerviran, dokler povezava ni javna. Celoten model je opisan v Deljenje in dostop.
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
| Ukaz | Izpiš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 (brez id) |
{items: [{id, name?, kind, access, url, people: [{email, accepted, invitedAt}]}], cursor}, najprej nazadnje deljeni |
links shared |
{items: [{_id, _creationTime, kind, title?, status, hasPassword, access, url, itemCount?, sharedBy?, sharedAt}], cursor}, najprej najnovejši |
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> (ali links update <id> --reset-share-link) |
{id, access, url} |
--role editor osebo nastavi kot urednika: lahko spreminja element in si ogleduje njegovo statistiko, ne more pa upravljati gesel, sluga, domene, dostopa in deljenja niti brisati, premikati ali kopirati, za cilj, zaščiten z geslom, pa mora najprej uporabiti links unlock (30 minut). Uredniki uporabljajo _id ali URL za deljenje iz links shared. Vsi ukazi sprejmejo --domain <host>, če se slug ponavlja. url v izpisu create, get, list, update, copy in share je URL za deljenje, razen če je povezava javna – takrat je to kratki URL; vrstice vsebujejo access. Do 200 oseb na element, 50 e-poštnih naslovov na klic, 100 e-poštnih povabil na račun na dan. Oba seznama izpišeta eno stran: --limit je 1-100 (privzeto 50); --cursor s prejšnje strani podajajte, dokler cursor ni null. links leave sprejme _id ali url iz links shared; dostop prek deljene nadrejene mape ostane. Deljenje, preklic deljenja, sprememba dostopa in ponastavitev štejejo vsak kot en dogodek; zapustitev ne.
Statistika
linkdash links stats <id> --last 24h
--last je trajanje (24h, 7d). Privzeto 24h. JSON vsebuje visits, downloads, plays, visitsInLast, countries, referrers, variants (seštevki po različicah), visitors (vsak z variant) in crawlers ([{crawler, company, category, hits, lastSeen}]: boti in predogledi povezav, ki so pridobili povezavo; nikoli se ne štejejo kot obiski).
CSV
Stolpci: slug,kind,name,variant,url,text,fileName,status,domain,tags,starts,expires,maxOpenings,weight,when,created,folder,access. Ena vrstica na različico. kind, status, url, text, fileName, weight in when (niz JSON) veljajo za posamezno različico; ostali veljajo za povezavo in se ponavljajo. folder je slug mape, v kateri je povezava. access je restricted, link ali public. Gesla, žetoni za deljenje in osebe niso vključeni.
linkdash links export > links.csv
linkdash links import links.csv
Uvoz združi vrstice po slugu in domeni. Prva vrstica ustvari povezavo z njeno različico; nadaljnje vrstice dodajo različice. Pri obstoječi povezavi prva vrstica posodobi polja povezave, nato vsaka vrstica posodobi različico z istim imenom, če obstaja, sicer jo doda. Vrstice datotek brez vsebine se preskočijo z napako za posamezno vrstico. Vrstice s kind = folder (z name) ustvarijo mape; stolpec folder vsako povezavo umesti v njeno mapo, ko obstajajo vse vrstice. Prazen access nove povezave nastavi kot omejene, obstoječe pa pusti nespremenjene.
Primeri
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
Glejte tudi mape, deljenje in dostop, webhooke in domene po meri.

