Skip to content
LinkdashLinkdash
Latviešu
Esc
↑↓navigate↵open⌘Jpreview
On this page

CLI

Instalējiet linkdash-cli no npm un pēc tam palaidiet komandu `linkdash`. Veiksmīgas komandas izvada JSON uz stdout. Palīdzība un kļūdas tiek izvadītas kā vienkāršs teksts uz stderr.

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

npm pakotne ir linkdash-cli. Komanda ir linkdash.

HTTP ekvivalents: HTTP API. MCP: MCP. Aģenta prasme: Aģenta prasme. Cenas: Cenas. Vienkāršs markdown: cli.md.

Karodziņa --json nav. Kļūdu gadījumā izejas kods ir 1.

Autentifikācija

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

Vēl nav konta? auth create atver https://linkdash.dev/sign-up un pēc tam atgriežas uz https://linkdash.dev/device ar CLI kodu, lai jūs varētu to apstiprināt. Konts jau ir? auth login atver /device. Bez grafiskās saskarnes: iestatiet LINKDASH_TOKEN uz sesijas marķieri, kas iegūts ar auth create vai auth login. Neizdomājiet marķierus.

Sesijas fails: ~/.config/linkdash/config.json (režīms 0600).

CLI nevar mainīt e-pasta adresi, paroli vai norēķinus. Novirziet lietotāju uz vadības paneli. API atslēgas (HTTP un MCP): API atslēgas.

Komandas

linkdash <command> [options]
Komanda Ko tā dara
auth create Reģistrācija pārlūkprogrammā, pēc tam ierīces apstiprināšana
auth login Pieteikšanās ar ierīci pārlūkprogrammā
auth logout Aizmirst saglabāto sesiju
auth whoami Pieteiktā konta JSON
links list Uzskaita saites un mapes pa vienai lapai (--limit, --cursor)
links get <id> Viena saite
links create --url <url> Īsā saite no URL
links create --file <path> Augšupielādē failu un iegūst saiti
links create --text <text> Saglabā fragmentu
links create --folder <name> Izveido mapi
links create --variant <name> … Saite ar vairākiem variantiem (sadalīšana / mērķēšana)
links update <id> Maina galamērķi, failu, paroli, derīguma termiņu, domēnu, statusu, piesaisti (sticky) vai pārsūtītos parametrus
links move <id> --in <folder-id> Ievieto saiti vai mapi mapē (--root augšējam līmenim)
links copy <id> Izveido kopiju ar jaunu slug tajā pašā mapē
links delete <id> Dzēš saiti (mapes vienumi tiek pārvietoti līmeni augstāk; --with-contents tos dzēš)
links share <id> --email <email> Kopīgo ar cilvēkiem pēc e-pasta adreses (atkārtojiet --email; --role editor ļauj viņiem to mainīt; katra jauna persona saņem ielūguma e-pastu)
links unshare <id> --email <email> Atņem kādam piekļuvi
links shares [id] Kas, izņemot jūs, var to atvērt, arī ar augstāk esošas mapes starpniecību. Bez id: viss, uz ko jūs uzaicinājāt cilvēkus, pa vienai lapai (--limit, --cursor)
links shared Ko citi cilvēki ir kopīgojuši ar jums, pa vienai lapai (--limit, --cursor)
links leave <_id | share URL> Atsakās no tā, kas kopīgots ar jums
links role <id> --email <e> --role viewer|editor Padara kādu jūsu uzaicinātu personu par skatītāju vai redaktoru
links unlock <_id | share URL> Ievada kopīgota vienuma paroli, lai 30 minūtes redzētu un rediģētu tā mērķi
links activity <id> Kas un kā mainīja vienumu
links reset-link <id> Jauns kopīgošanas URL; vecais linkdash.dev/s/ URL pārstāj darboties
links stats <id> Apmeklējumu, lejupielāžu un atskaņojumu kopsummas, arī katram variantam, kā arī rāpuļprogrammas
links export Izvada visas saites kā CSV (viena rinda katram variantam)
links import <file> Importē URL un teksta rindas no CSV
links variants list <id> Saites varianti
links variants add <id> --name <n> Pievieno variantu
links variants update <id> <name> Maina variantu
links variants remove <id> <name> Noņem variantu
webhooks list Uzskaita webhook galapunktus (noslēpums maskēts)
webhooks get <id> Parāda viena webhook URL (noslēpums maskēts)
webhooks create --url <https> Pievieno HTTPS galapunktu (noslēpums tiek parādīts vienreiz)
webhooks rotate <id> Izsniedz jaunu parakstīšanas noslēpumu
webhooks delete <id> Noņem webhook
domains list Uzskaita pielāgotos resursdatoru nosaukumus
domains add <host> Pievieno resursdatora nosaukumu (1 plānā Free)
domains connect <host> Domain Connect lietošanas URL vai null
domains verify <host> Pārbauda DNS ar Unkey
domains remove <host> Noņem resursdatora nosaukumu
-h, --help Palīdzība (vienkāršs teksts)
-v, --version Versija

Ja viens un tas pats slug pastāv divos īpašnieka domēnos, norādiet --domain.

Izveides un atjaunināšanas karodziņi

Slug ir saites id un, ja saite ir publiska, arī tās publiskais ceļš. Nosaukums ir redzams tikai jums. Jaunās saites ir ierobežotas (skatiet Piekļuve un kopīgošana). Izveidei jānorāda tieši viens no šiem: --url, --file vai --text (tas kļūst par variantu main), --variant bloki (skatiet Varianti) vai --folder <name> (skatiet Mapes).

Karodziņš Piezīmes
--url <url> Galamērķa URL
--file <path> Augšupielādējamais fails (izveidei vai baitu aizstāšanai atjaunināšanas laikā)
--text <text> Fragments
--access <restricted|link|public> Kas var to atvērt. Noklusējums restricted. Skatiet Piekļuve un kopīgošana
--reset-share-link Izsniedz jaunu kopīgošanas URL (tikai atjaunināšanai)
--slug <id> Publiskais ceļš: a-z0-9 un iekšējās defises, 1–64
--name <label> Privāta etiķete
--tag <tag> Atkārtojams. Mazie burti, bez komatiem. Maks. 20
--starts <when> Aktivizē pēc 7d, 24h, 30m vai ISO datumā
--password <secret> Atvēršanai pieprasa šo paroli
--expires <when> Pārtrauc apkalpošanu pēc 7d, 24h, 30m vai ISO datumā
--max-openings <n> Aptur pēc šāda atvēršanas reižu skaita. Izlaidiet, lai ierobežojuma nebūtu
--domain <host> Apkalpo šajā resursdatorā, nevis lida.sh
--in <folder-id> Izveido šajā mapē (tikai izveidei; --in-domain <host>, ja mapes slug atkārtojas)
--status <active|paused> Aptur vai atsāk (tikai atjaunināšanai)
--sticky / --no-sticky Atkārtots apmeklētājs saglabā to pašu variantu (noklusējums — sticky)
--restart-split Pārjauc piesaistītos piešķīrumus (tikai atjaunināšanai)
--forward-params / --no-forward-params Pievieno apmeklētāja vaicājuma virkni URL variantiem (noklusējumā izslēgts). Skatiet Vaicājuma parametru pārsūtīšana
--variant <name> Sāk varianta bloku (tikai izveidei). Skatiet Varianti
--weight <n> --when <key=v1,v2> Katram variantam. Skatiet Varianti un Vaicājuma parametru noteikumi
--preview-name <text> Publiskais priekšskatījuma nosaukums
--preview-description <text> Publiskais priekšskatījuma apraksts
--preview-image <path> Publiskais priekšskatījuma attēls
--utm-source --utm-medium --utm-campaign --utm-term --utm-content Tikai URL saitēm
--clear-password --clear-expires --clear-starts --clear-tags --clear-preview --clear-name --clear-max-openings Tikai atjaunināšanai

--status pieņem tikai active vai paused. Statuss „expired” izriet no --expires. Statuss „scheduled” izriet no --starts. Līdz sākumam publiskā atrisināšana atgriež „not found”. Kad sasniegts --max-openings, saite tiek apturēta; lai to atkal apkalpotu, palieliniet skaitu vai izmantojiet --clear-max-openings. Jau izmantotās atvēršanas reizes tiek skaitītas, līdz jūs maināt vai noņemat ierobežojumu.

lida.sh slug ir koplietoti. Ja vārds jau ir aizņemts, pievienojiet pielāgotu domēnu un mēģiniet vēlreiz ar --domain. Saite zīmola domēnā netiek papildus publicēta arī lida.sh.

Saraksta karodziņi

Izvada vienu lapu, {items, cursor}: --limit ir 1-100 (noklusējums 50); norādiet --cursor ar iepriekšējās lapas cursor vērtību, līdz tā ir null. Lapā var būt mazāk vienumu nekā --limit, ja filtrs dažus izlaiž. --q atbilst veseliem vārdiem, pēdējo uzskatot par prefiksu (laun atrod example.com/launch), un rezultāti tiek kārtoti pēc atbilstības; --in uzskaita vienas mapes saturu, vispirms mapes; pretējā gadījumā vispirms jaunākie.

Karodziņš Piezīmes
--limit <n> Vienumu skaits lapā, 1-100 (noklusējums 50)
--cursor <c> cursor no iepriekšējās lapas
--q <text> Meklē vārdus nosaukumā, slug, variantu nosaukumos un mērķos, failu nosaukumos, fragmentu tekstā un tagos
--tag <tag> Filtrē pēc taga
--kind <url|file|text|folder|group> Filtrē pēc veida (group = vairāki varianti)
--status <status> active, paused, expired, scheduled vai mixed
--in <folder-id|root> Tikai tas, kas atrodas tieši šajā mapē vai augšējā līmenī. Bez tā tiek uzskaitīts viss

Varianti

Katra saite ir viena vai vairāku variantu konteiners. Variants ir saturs (URL, fails vai teksts) kopā ar saviem ierobežojumiem (--password, --starts, --expires, --max-openings), --weight un neobligātiem apmeklētāja nosacījumiem (--when). Bez --variant saitei ir viens variants ar nosaukumu main, un katra iepriekš minētā komanda ir tā saīsinājums. Apmeklētājs saņem vienu variantu: varianti, kuru --when atbilst, veido kopu (ja neviens neatbilst, kopu veido beznosacījuma varianti), pēc tam notiek svērta izvēle. Ar piesaistīto piešķiršanu (noklusējums) atkārtots apmeklētājs saglabā to pašu variantu. Saites pašas ierobežojumiem ir prioritāte pār variantu ierobežojumiem. Variantu nosaukumi: mazie burti, cipari, iekšējās defises, 1–40 rakstzīmes, unikāli katrai saitei. Maks. 20 varianti.

Saites kind ir varianta veids, ja variants ir viens, un group, ja to ir vairāki. Saites status ir saites ierobežojums, ja tas iestatīts (paused, scheduled, expired), citādi visiem variantiem kopīgais statuss, citādi mixed. variantStatuses uzskaita {active, paused, expired, scheduled}.

Izveide ar variantu blokiem

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> sāk varianta bloku. Karodziņi pēc tā attiecas uz šo variantu līdz nākamajam --variant: --url|--file|--text, --password, --starts, --expires, --max-openings, --weight <n>, --when <key=v1,v2> (atkārtojams), --utm-*. Saites karodziņus (--slug --name --tag --domain --preview-* --password --starts --expires --max-openings --sticky --no-sticky --forward-params) norāda pirms pirmā --variant.

Variantu apakškomandas

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> pieņem vienu no --url, --file, --text, kā arī ierobežojumu karodziņus, --weight, --when, --utm-*. variants update <id> <name> pieņem --name <new>, saturu, ierobežojumu karodziņus, --status active|paused, --weight, --when, --clear-when, --clear-password, --clear-starts, --clear-expires, --clear-max-openings. Saitei vienmēr paliek vismaz viens variants.

--when atslēgas

Atslēga JSON lauks Vērtības
country countries ISO-2 kodi (DE, AT)
device devices mobile tablet desktop
os os windows macos android ios linux other
browser browsers edge chrome firefox safari other
language languages prefiksa atbilstība (de, en-us)
referrer referrerHosts resursdatora sufikss (twitter.com)

Jāatbilst katrai iestatītajai atslēgai. --when country=DE,AT --when device=mobile atbilst { "countries": ["DE","AT"], "devices": ["mobile"] }.

Vaicājuma parametru noteikumi

--when pieņem arī param: noteikumus apmeklētāja vaicājuma virknei (lida.sh/promo?src=newsletter). Atslēgās tiek ņemts vērā lielo un mazo burtu reģistrs, vērtības tiek salīdzinātas precīzi, maks. 10 noteikumi katram variantam. Komati sadala --when, tāpēc parametra vērtība nevar saturēt komatu; sarakstiem izmantojiet |.

Sintakse JSON op Atbilst, ja
param:KEY=VALUE equals vērtība ir tieši VALUE
param:KEY!=VALUE notEquals vērtība atšķiras vai atslēgas nav
param:KEY~=VALUE includes vērtība satur VALUE
param:KEY^=VALUE startsWith vērtība sākas ar VALUE
param:KEY$=VALUE endsWith vērtība beidzas ar VALUE
param:KEY=v1|v2 in vērtība ir viena no saraksta vērtībām
param:KEY? vai param:KEY exists atslēga ir klātesoša
param:!KEY missing atslēgas nav
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?"

JSON struktūra: "when": { "params": [{ "key": "src", "op": "equals", "value": "newsletter" }] } (exists / missing gadījumā value tiek izlaists). Parametru vērtības tiek salīdzinātas atvēršanas brīdī un nekad netiek saglabātas analītikā.

Vaicājuma parametru pārsūtīšana

--forward-params / --no-forward-params komandās links create un links update (saites līmenī, noklusējumā izslēgts) pievieno visu apmeklētāja vaicājuma virkni URL variantiem: lida.sh/promo?src=nl atver https://example.com/?src=nl. Apmeklētāja vērtības aizstāj saglabātās, ieskaitot --utm-*. Failu un teksta varianti to ignorē. Tā ir maršrutēšana, nevis piekļuves kontrole: parametrus var pievienot ikviens. Parametru vērtības netiek saglabātas analītikā. links get to parāda kā forwardParams.

Piesaiste un sadalījuma atiestatīšana

links update <id> --sticky / --no-sticky nosaka, vai atkārtots apmeklētājs saglabā to pašu variantu. links update <id> --restart-split pārjauc piesaistītos piešķīrumus. Satura karodziņi komandā links update darbojas tikai saitēm ar vienu variantu; citos gadījumos izmantojiet links variants update <id> <name>.

Mapes

Mape ir saite, kas uzskaita tajā ievietotos vienumus. Par to, kā darbojas publiskā lapa un piekļuve, skatiet Mapes.

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> iestata mapes nosaukumu (nevis --name) un pieņem --slug, --domain, --password, --starts, --expires, --max-openings, --tag, --preview-* un --in. To nevar apvienot ar --url, --file, --text vai --variant. links move izvada {id, folder}. links copy saglabā piekļuves līmeni, bet iegūst jaunu kopīgošanas URL; cilvēki netiek kopēti. links delete mapei pārvieto tās vienumus līmeni augstāk; --with-contents dzēš arī tos. Komandu list, get un create rindās ir folder (saturošās mapes slug vai null); mapju rindās ir arī items.

Piekļuve un kopīgošana

Jaunās saites un mapes ir restricted: to url ir https://linkdash.dev/s/<token>, ko pēc pieteikšanās var atvērt tikai jūs un cilvēki, ar kuriem jūs to kopīgojat. --access link padara šo URL atveramu ikvienam, kam tas ir. --access public apkalpo saiti tās īsajā URL (lida.sh/<slug> vai jūsu pielāgotajā domēnā). Izmantojiet --access public saitēm, kuras publicējat atklāti. Slug paliek id visām komandām, un tā īsais URL paliek rezervēts, kamēr saite nav publiska. Pilnu modeli skatiet sadaļā Kopīgošana un piekļuve.

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
Komanda Izvada
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}, vispirms nesen kopīgotie
links shared {items: [{_id, _creationTime, kind, title?, status, hasPassword, access, url, itemCount?, sharedBy?, sharedAt}], cursor}, vispirms jaunākie
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> (vai links update <id> --reset-share-link) {id, access, url}

--role editor padara kādu par redaktoru: redaktors var mainīt vienumu un redzēt tā statistiku, bet nevar mainīt paroles, slug, domēnu, piekļuvi un kopīgošanu, kā arī nevar dzēst, pārvietot vai kopēt, un ar paroli aizsargātam mērķim vispirms nepieciešams links unlock (30 minūtes). Redaktori izmanto _id vai kopīgošanas URL no links shared. Visas komandas pieņem --domain <host>, ja slug atkārtojas. url komandu create, get, list, update, copy un share izvadē ir kopīgošanas URL, ja vien saite nav publiska — tad tas ir īsais URL; rindās ir access. Līdz 200 cilvēkiem uz vienumu, 50 e-pasta adreses vienā izsaukumā, 100 ielūguma e-pasti uz kontu dienā. Abi saraksti izvada vienu lapu: --limit ir 1-100 (noklusējums 50); norādiet --cursor no iepriekšējās lapas, līdz cursor ir null. links leave pieņem _id vai url no links shared; piekļuve ar augstāk esošas kopīgotas mapes starpniecību saglabājas. Kopīgošana, kopīgošanas atcelšana, piekļuves maiņa un atiestatīšana katra tiek uzskaitīta kā viens notikums; aiziešana — ne.

Statistika

linkdash links stats <id> --last 24h

--last ir ilgums (24h, 7d). Noklusējums 24h. JSON ietver visits, downloads, plays, visitsInLast, countries, referrers, variants (kopsummas katram variantam), visitors (katram ir variant) un crawlers ([{crawler, company, category, hits, lastSeen}]: roboti un saišu priekšskatījumi, kas ielādēja saiti; tie nekad netiek skaitīti kā apmeklējumi).

CSV

Kolonnas: slug,kind,name,variant,url,text,fileName,status,domain,tags,starts,expires,maxOpenings,weight,when,created,folder,access. Viena rinda katram variantam. kind, status, url, text, fileName, weight un when (JSON virkne) attiecas uz variantu; pārējās attiecas uz saiti un atkārtojas. folder ir tās mapes slug, kurā atrodas saite. access ir restricted, link vai public. Paroles, kopīgošanas marķieri un cilvēki netiek iekļauti.

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

Importēšana grupē rindas pēc slug + domēna. Pirmā rinda izveido saiti ar tās variantu; nākamās rindas pievieno variantus. Esošai saitei pirmā rinda atjaunina saites laukus, pēc tam katra rinda atjaunina variantu pēc nosaukuma, ja tāds pastāv, citādi to pievieno. Failu rindas bez baitiem tiek izlaistas, norādot kļūdu attiecīgajai rindai. Rindas ar kind = folder (ar name) izveido mapes; kolonna folder ievieto katru saiti tās mapē, kad visas rindas jau pastāv. Tukšs access padara jaunās saites ierobežotas un atstāj esošās saites nemainītas.

Piemēri

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

Skatiet arī mapes, kopīgošanu un piekļuvi, webhooks un pielāgotos domēnus.

Was this page helpful?