Skip to content
LinkdashLinkdash
Slovenščina
Esc
↑↓navigate↵open⌘Jpreview
On this page

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.

Was this page helpful?