CLI
Instalirajte linkdash-cli s npm-a, a zatim pokrenite naredbu `linkdash`. Uspješne naredbe ispisuju JSON na stdout. Pomoć i pogreške ispisuju se kao običan tekst na stderr.
npm i -g linkdash-cli
# or: pnpm add -g linkdash-cli / bun add -g linkdash-cli / npx linkdash-cli@latest
Paket na npm-u zove se linkdash-cli. Naredba je linkdash.
HTTP ekvivalent: HTTP API. MCP: MCP. Vještina za agente: Vještina za agente. Cijene: Cijene. Običan markdown: cli.md.
Zastavica --json ne postoji. U slučaju pogreške izlazni kod je 1.
Autentifikacija
linkdash auth create
linkdash auth login
linkdash auth whoami
linkdash auth logout
Još nemate račun? auth create otvara https://linkdash.dev/sign-up, a zatim se vraća na https://linkdash.dev/device s CLI kodom kako biste mogli odobriti prijavu. Već imate račun? auth login otvara /device. Bez preglednika (headless): postavite LINKDASH_TOKEN na token sesije dobiven naredbom auth create ili auth login. Ne izmišljajte tokene.
Datoteka sesije: ~/.config/linkdash/config.json (dozvole 0600).
CLI ne može mijenjati e-adresu, lozinku ni naplatu. Uputite korisnika na nadzornu ploču. API ključevi (HTTP i MCP): API ključevi.
Naredbe
linkdash <command> [options]
| Naredba | Što radi |
|---|---|
auth create |
Registracija u pregledniku, zatim odobrenje uređaja |
auth login |
Prijava uređaja putem preglednika |
auth logout |
Briše spremljenu sesiju |
auth whoami |
JSON prijavljenog računa |
links list |
Ispisuje poveznice i mape, stranicu po stranicu (--limit, --cursor) |
links get <id> |
Jedna poveznica |
links create --url <url> |
Kratka poveznica iz URL-a |
links create --file <path> |
Učitava datoteku i vraća poveznicu |
links create --text <text> |
Sprema isječak teksta |
links create --folder <name> |
Stvara mapu |
links create --variant <name> … |
Poveznica s više varijanti (podjela / ciljanje) |
links update <id> |
Mijenja odredište, datoteku, lozinku, istek, domenu, status, trajnu dodjelu (sticky) ili proslijeđene parametre |
links move <id> --in <folder-id> |
Stavlja poveznicu ili mapu u mapu (--root za najvišu razinu) |
links copy <id> |
Izrađuje kopiju s novim slugom u istoj mapi |
links delete <id> |
Briše poveznicu (stavke mape premještaju se razinu više; --with-contents ih briše) |
links share <id> --email <email> |
Dijeli s osobama putem e-pošte (ponovite --email; --role editor im omogućuje izmjene; svaka nova osoba dobiva pozivnicu e-poštom) |
links unshare <id> --email <email> |
Uklanja nečiji pristup |
links shares [id] |
Tko osim vas može otvoriti stavku, uključujući pristup putem nadređene mape. Bez id-a: sve na što ste pozvali druge, stranicu po stranicu (--limit, --cursor) |
links shared |
Što su drugi podijelili s vama, stranicu po stranicu (--limit, --cursor) |
links leave <_id | share URL> |
Odustaje od nečega što je podijeljeno s vama |
links role <id> --email <e> --role viewer|editor |
Osobu koju ste pozvali postavlja kao preglednika ili urednika |
links unlock <_id | share URL> |
Unosi lozinku podijeljene stavke kako biste 30 minuta mogli vidjeti i uređivati njezino odredište |
links activity <id> |
Tko je i kako mijenjao stavku |
links reset-link <id> |
Novi URL za dijeljenje; stari URL linkdash.dev/s/ prestaje raditi |
links stats <id> |
Ukupni posjeti, preuzimanja i reprodukcije, i po varijanti, te crawleri |
links export |
Ispisuje sve poveznice kao CSV (jedan redak po varijanti) |
links import <file> |
Uvozi retke s URL-ovima i tekstom iz CSV-a |
links variants list <id> |
Varijante poveznice |
links variants add <id> --name <n> |
Dodaje varijantu |
links variants update <id> <name> |
Mijenja varijantu |
links variants remove <id> <name> |
Uklanja varijantu |
webhooks list |
Ispisuje webhook krajnje točke (tajna je maskirana) |
webhooks get <id> |
Prikazuje jedan webhook URL (tajna je maskirana) |
webhooks create --url <https> |
Dodaje HTTPS krajnju točku (tajna se prikazuje samo jednom) |
webhooks rotate <id> |
Izdaje novu tajnu za potpisivanje |
webhooks delete <id> |
Uklanja webhook |
domains list |
Ispisuje prilagođene nazive hostova |
domains add <host> |
Dodaje naziv hosta (1 na planu Free) |
domains connect <host> |
URL za primjenu putem Domain Connecta ili null |
domains verify <host> |
Provjerava DNS putem Unkeya |
domains remove <host> |
Uklanja naziv hosta |
-h, --help |
Pomoć (običan tekst) |
-v, --version |
Verzija |
Ako isti slug postoji na dvije vlasnikove domene, navedite --domain.
Zastavice za stvaranje i ažuriranje
Slug je id poveznice i njezina javna putanja kada je poveznica javna. Naziv vidite samo vi. Nove poveznice su ograničene (pogledajte Pristup i dijeljenje). Stvaranje prima točno jedno od sljedećeg: --url, --file ili --text (to postaje varijanta main), blokove --variant (pogledajte Varijante) ili --folder <name> (pogledajte Mape).
| Zastavica | Napomene |
|---|---|
--url <url> |
Odredišni URL |
--file <path> |
Datoteka za učitavanje (pri stvaranju ili za zamjenu sadržaja pri ažuriranju) |
--text <text> |
Isječak teksta |
--access <restricted|link|public> |
Tko je može otvoriti. Zadano restricted. Pogledajte Pristup i dijeljenje |
--reset-share-link |
Izdaje novi URL za dijeljenje (samo pri ažuriranju) |
--slug <id> |
Javna putanja: a-z0-9 i unutarnje crtice, 1–64 znaka |
--name <label> |
Privatna oznaka |
--tag <tag> |
Može se ponavljati. Mala slova, bez zareza. Najviše 20 |
--starts <when> |
Aktivira se nakon 7d, 24h, 30m ili na ISO datum |
--password <secret> |
Za otvaranje se traži ova lozinka |
--expires <when> |
Prestaje se posluživati nakon 7d, 24h, 30m ili na ISO datum |
--max-openings <n> |
Pauzira se nakon ovoliko otvaranja. Izostavite za neograničeno |
--domain <host> |
Poslužuje se na ovom hostu umjesto na lida.sh |
--in <folder-id> |
Stvara unutar ove mape (samo pri stvaranju; --in-domain <host> ako se slug mape ponavlja) |
--status <active|paused> |
Pauzira ili nastavlja (samo pri ažuriranju) |
--sticky / --no-sticky |
Posjetitelj koji se vraća zadržava istu varijantu (zadano sticky) |
--restart-split |
Iznova raspoređuje trajne dodjele (samo pri ažuriranju) |
--forward-params / --no-forward-params |
Dodaje posjetiteljev query string URL varijantama (zadano isključeno). Pogledajte Prosljeđivanje query parametara |
--variant <name> |
Započinje blok varijante (samo pri stvaranju). Pogledajte Varijante |
--weight <n> --when <key=v1,v2> |
Po varijanti. Pogledajte Varijante i Pravila za query parametre |
--preview-name <text> |
Javni naziv u pregledu poveznice |
--preview-description <text> |
Javni opis u pregledu poveznice |
--preview-image <path> |
Javna slika u pregledu poveznice |
--utm-source --utm-medium --utm-campaign --utm-term --utm-content |
Samo za URL poveznice |
--clear-password --clear-expires --clear-starts --clear-tags --clear-preview --clear-name --clear-max-openings |
Samo pri ažuriranju |
--status prihvaća samo active ili paused. Status isteka proizlazi iz --expires. Status zakazanog proizlazi iz --starts. Do početka javno razrješavanje vraća not-found. Kada se dosegne --max-openings, poveznica se pauzira; povećajte broj ili upotrijebite --clear-max-openings kako bi se ponovno posluživala. Već iskorištena otvaranja ostaju ubrojena dok ne promijenite ili uklonite ograničenje.
Slugovi na lida.sh su zajednički. Ako je riječ zauzeta, dodajte prilagođenu domenu i pokušajte ponovno s --domain. Poveznica na brendiranoj domeni ne objavljuje se usto i na lida.sh.
Zastavice za ispis
Ispisuje jednu stranicu, {items, cursor}: --limit je 1-100 (zadano 50); prosljeđujte --cursor s vrijednošću cursor iz prethodne stranice sve dok ne bude null. Stranica može sadržavati manje stavki od --limit kada filtar neke preskoči. --q traži podudaranje cijelih riječi, pri čemu se posljednja tretira kao prefiks (laun pronalazi example.com/launch), a rezultati su poredani po relevantnosti; --in ispisuje jednu mapu, s mapama na početku; inače su najnovije stavke prve.
| Zastavica | Napomene |
|---|---|
--limit <n> |
Broj stavki po stranici, 1-100 (zadano 50) |
--cursor <c> |
cursor iz prethodne stranice |
--q <text> |
Pretražuje riječi u nazivu, slugu, nazivima i odredištima varijanti, nazivima datoteka, tekstu isječaka i oznakama |
--tag <tag> |
Filtrira po oznaci |
--kind <url|file|text|folder|group> |
Filtrira po vrsti (group = više varijanti) |
--status <status> |
active, paused, expired, scheduled ili mixed |
--in <folder-id|root> |
Samo ono što je izravno u ovoj mapi ili na najvišoj razini. Bez nje ispisuje se sve |
Varijante
Svaka poveznica spremnik je jedne ili više varijanti. Varijanta je sadržaj (URL, datoteka ili tekst) zajedno s vlastitim ograničenjima pristupa (--password, --starts, --expires, --max-openings), težinom --weight i neobaveznim uvjetima za posjetitelje (--when). Bez --variant poveznica ima jednu varijantu naziva main, a svaka gornja naredba skraćeni je oblik za nju. Posjetitelj dobiva jednu varijantu: varijante čiji se --when podudara čine skup (ako se nijedna ne podudara, skup čine bezuvjetne varijante), a zatim slijedi odabir prema težini. Uz trajnu dodjelu (zadano) posjetitelj koji se vraća zadržava istu varijantu. Ograničenja same poveznice imaju prednost pred ograničenjima varijanti. Nazivi varijanti: mala slova, znamenke, unutarnje crtice, 1–40 znakova, jedinstveni unutar poveznice. Najviše 20 varijanti.
kind poveznice jednak je vrsti varijante kada postoji jedna varijanta, odnosno group kada ih je više. status poveznice je status ograničenja poveznice kada je postavljen (paused, scheduled, expired), inače zajednički status varijanti, a inače mixed. variantStatuses broji {active, paused, expired, scheduled}.
Stvaranje s blokovima varijanti
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> započinje blok varijante. Zastavice nakon nje pripadaju toj varijanti do sljedećeg --variant: --url|--file|--text, --password, --starts, --expires, --max-openings, --weight <n>, --when <key=v1,v2> (može se ponavljati), --utm-*. Zastavice poveznice (--slug --name --tag --domain --preview-* --password --starts --expires --max-openings --sticky --no-sticky --forward-params) navode se prije prvog --variant.
Podnaredbe za varijante
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> prima jedno od --url, --file, --text te zastavice ograničenja, --weight, --when, --utm-*. variants update <id> <name> prima --name <new>, sadržaj, zastavice ograničenja, --status active|paused, --weight, --when, --clear-when, --clear-password, --clear-starts, --clear-expires, --clear-max-openings. Poveznica uvijek zadržava barem jednu varijantu.
Ključevi za --when
| Ključ | JSON polje | Vrijednosti |
|---|---|---|
country |
countries |
ISO-2 kodovi (DE, AT) |
device |
devices |
mobile tablet desktop |
os |
os |
windows macos android ios linux other |
browser |
browsers |
edge chrome firefox safari other |
language |
languages |
podudaranje prefiksa (de, en-us) |
referrer |
referrerHosts |
sufiks hosta (twitter.com) |
Svaki postavljeni ključ mora se podudarati. --when country=DE,AT --when device=mobile odgovara { "countries": ["DE","AT"], "devices": ["mobile"] }.
Pravila za query parametre
--when prima i pravila param: za posjetiteljev query string (lida.sh/promo?src=newsletter). Ključevi razlikuju velika i mala slova, vrijednosti se uspoređuju točno, a dopušteno je najviše 10 pravila po varijanti. Zarezi razdvajaju --when, pa vrijednost parametra ne može sadržavati zarez; za popise upotrijebite |.
| Sintaksa | JSON op |
Podudara se kada |
|---|---|---|
param:KEY=VALUE |
equals |
je vrijednost točno VALUE |
param:KEY!=VALUE |
notEquals |
je vrijednost drukčija ili ključ ne postoji |
param:KEY~=VALUE |
includes |
vrijednost sadrži VALUE |
param:KEY^=VALUE |
startsWith |
vrijednost počinje s VALUE |
param:KEY$=VALUE |
endsWith |
vrijednost završava s VALUE |
param:KEY=v1|v2 |
in |
je vrijednost jedna od navedenih na popisu |
param:KEY? or param:KEY |
exists |
ključ postoji |
param:!KEY |
missing |
ključ ne postoji |
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?"
Oblik JSON-a: "when": { "params": [{ "key": "src", "op": "equals", "value": "newsletter" }] } (value se izostavlja za exists / missing). Vrijednosti parametara uspoređuju se u trenutku otvaranja i nikada se ne spremaju u analitiku.
Prosljeđivanje query parametara
--forward-params / --no-forward-params uz links create i links update (na razini poveznice, zadano isključeno) dodaje cijeli posjetiteljev query string URL varijantama: lida.sh/promo?src=nl otvara https://example.com/?src=nl. Posjetiteljeve vrijednosti nadjačavaju spremljene, uključujući --utm-*. Varijante s datotekom i tekstom to zanemaruju. Ovo je usmjeravanje, a ne kontrola pristupa: svatko može dodati parametre. Vrijednosti parametara ne spremaju se u analitiku. links get to prikazuje kao forwardParams.
Trajna dodjela i ponovno pokretanje podjele
links update <id> --sticky / --no-sticky određuje zadržava li posjetitelj koji se vraća istu varijantu. links update <id> --restart-split iznova raspoređuje trajne dodjele. Zastavice sadržaja uz links update rade samo za poveznice s jednom varijantom; u suprotnom upotrijebite links variants update <id> <name>.
Mape
Mapa je poveznica koja prikazuje stavke koje ste u nju stavili. Kako funkcioniraju javna stranica i pristup, pogledajte u 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> postavlja naziv mape (ne --name) i prima --slug, --domain, --password, --starts, --expires, --max-openings, --tag, --preview-* i --in. Ne može se kombinirati s --url, --file, --text ili --variant. links move ispisuje {id, folder}. links copy zadržava razinu pristupa, ali dobiva novi URL za dijeljenje; osobe se ne kopiraju. links delete nad mapom premješta njezine stavke razinu više; --with-contents briše i njih. Retci iz list, get i create sadrže folder (slug mape u kojoj se stavka nalazi ili null); retci mapa sadrže i items.
Pristup i dijeljenje
Nove poveznice i mape su restricted: njihov url je https://linkdash.dev/s/<token>, koji mogu otvoriti samo vi i osobe s kojima dijelite, uz prijavu. --access link otvara taj URL svakome tko ga ima. --access public poslužuje poveznicu na njezinu kratkom URL-u (lida.sh/<slug> ili na vašoj prilagođenoj domeni). Upotrijebite --access public za poveznice koje objavljujete javno. Slug ostaje id za svaku naredbu, a njegov kratki URL ostaje rezerviran dok poveznica nije javna. Cjelovit model opisan je u Dijeljenje i pristup.
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
| Naredba | Ispisuje |
|---|---|
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-a) |
{items: [{id, name?, kind, access, url, people: [{email, accepted, invitedAt}]}], cursor}, najprije posljednje podijeljeno |
links shared |
{items: [{_id, _creationTime, kind, title?, status, hasPassword, access, url, itemCount?, sharedBy?, sharedAt}], cursor}, najprije najnovije |
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> (ili links update <id> --reset-share-link) |
{id, access, url} |
--role editor nekoga čini urednikom: urednik može mijenjati stavku i vidjeti njezinu statistiku, ali ne može mijenjati lozinke, slug, domenu, pristup ni dijeljenje, niti brisati, premještati ili kopirati stavku, a za odredište zaštićeno lozinkom najprije je potreban links unlock (30 minuta). Urednici upotrebljavaju _id ili URL za dijeljenje iz links shared. Sve naredbe primaju --domain <host> kada se slug ponavlja. url u izlazu naredbi create, get, list, update, copy i share je URL za dijeljenje, osim ako je poveznica javna, kada je to kratki URL; retci sadrže access. Najviše 200 osoba po stavci, 50 e-adresa po pozivu i 100 e-poruka s pozivnicom po računu dnevno. Oba popisa ispisuju jednu stranicu: --limit je 1-100 (zadano 50); prosljeđujte --cursor iz prethodne stranice dok cursor ne bude null. links leave prima _id ili url iz links shared; pristup putem podijeljene nadređene mape ostaje. Dijeljenje, ukidanje dijeljenja, promjena pristupa i ponovno postavljanje poveznice broje se svaki kao jedan događaj; napuštanje se ne broji.
Statistika
linkdash links stats <id> --last 24h
--last je trajanje (24h, 7d). Zadano 24h. JSON sadrži visits, downloads, plays, visitsInLast, countries, referrers, variants (ukupni podaci po varijanti), visitors (svaki s variant) i crawlers ([{crawler, company, category, hits, lastSeen}]: botovi i pregledi poveznica koji su dohvatili poveznicu, a nikada se ne broje kao posjeti).
CSV
Stupci: slug,kind,name,variant,url,text,fileName,status,domain,tags,starts,expires,maxOpenings,weight,when,created,folder,access. Jedan redak po varijanti. kind, status, url, text, fileName, weight i when (JSON niz znakova) odnose se na varijantu; ostali se odnose na poveznicu i ponavljaju se. folder je slug mape u kojoj se poveznica nalazi. access je restricted, link ili public. Lozinke, tokeni za dijeljenje i osobe nisu uključeni.
linkdash links export > links.csv
linkdash links import links.csv
Uvoz grupira retke prema slugu + domeni. Prvi redak stvara poveznicu s njezinom varijantom; dodatni retci dodaju varijante. Za postojeću poveznicu prvi redak ažurira polja poveznice, a zatim svaki redak ažurira varijantu prema nazivu ako postoji, a inače je dodaje. Retci s datotekama bez sadržaja preskaču se uz pogrešku za taj redak. Retci s kind = folder (s vrijednošću name) stvaraju mape; stupac folder smješta svaku poveznicu u njezinu mapu nakon što su svi retci stvoreni. Prazan access čini nove poveznice ograničenima, a postojeće ostavlja nepromijenjenima.
Primjeri
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
Pogledajte i mape, dijeljenje i pristup, webhookove i prilagođene domene.

