Siirry sisältöön
LinkdashLinkdash
Suomi
Esc
↑↓siirry↵avaa⌘Jesikatselu
Tällä sivulla

CLI

Asenna linkdash-cli npm:stä ja aja sitten `linkdash`-komento. Onnistuneet komennot tulostavat JSONia stdoutiin. Ohje ja virheet tulostetaan pelkkänä tekstinä stderriin.

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

npm-paketti on linkdash-cli. Komento on linkdash.

HTTP-vastine: HTTP API. MCP: MCP. Agenttitaito: Agenttitaito. Hinnoittelu: Hinnoittelu. Pelkkä markdown: cli.md.

--json-lippua ei ole. Virheissä poistumiskoodi on 1.

Tunnistautuminen

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

Eikö sinulla ole vielä tiliä? auth create avaa osoitteen https://linkdash.dev/sign-up ja palaa sitten osoitteeseen https://linkdash.dev/device CLI-koodin kanssa, jotta voit hyväksyä sen. Onko sinulla jo tili? auth login avaa sivun /device. Ilman selainta: aseta LINKDASH_TOKEN-muuttujaan istuntotunnus, jonka sait komennolla auth create tai auth login. Älä keksi tunnuksia itse.

Istuntotiedosto: ~/.config/linkdash/config.json (oikeudet 0600).

CLI ei voi muuttaa sähköpostia, salasanaa tai laskutusta. Ohjaa käyttäjä hallintapaneeliin. API-avaimet (HTTP ja MCP): API-avaimet.

Komennot

linkdash <command> [options]
Komento Mitä se tekee
auth create Rekisteröityminen selaimessa, sitten laitteen hyväksyntä
auth login Laitekirjautuminen selaimessa
auth logout Unohda tallennettu istunto
auth whoami Kirjautuneen tilin JSON
links list Listaa linkit ja kansiot sivu kerrallaan (--limit, --cursor)
links get <id> Yksi linkki
links create --url <url> Lyhytlinkki URL-osoitteesta
links create --file <path> Lähetä tiedosto ja saat linkin
links create --text <text> Tallenna tekstikatkelma
links create --folder <name> Luo kansio
links create --variant <name> … Linkki, jossa on useita variantteja (jako / kohdennus)
links update <id> Muuta kohdetta, tiedostoa, salasanaa, vanhenemista, verkkotunnusta, tilaa, pysyvyyttä tai välitettäviä parametreja
links move <id> --in <folder-id> Siirrä linkki tai kansio kansioon (--root ylimmälle tasolle)
links copy <id> Tee kopio uudella slugilla samaan kansioon
links delete <id> Poista linkki (kansion kohteet siirtyvät tasoa ylemmäs; --with-contents poistaa ne)
links share <id> --email <email> Jaa ihmisille sähköpostilla (toista --email; --role editor antaa heidän muuttaa sitä; jokainen uusi henkilö saa kutsusähköpostin)
links unshare <id> --email <email> Poista joltakulta käyttöoikeus
links shares [id] Ketkä voivat avata sen sinun lisäksesi, myös sen yläpuolella olevan kansion kautta. Ilman id:tä: kaikki, mihin olet kutsunut ihmisiä, sivu kerrallaan (--limit, --cursor)
links shared Mitä muut ovat jakaneet sinulle, sivu kerrallaan (--limit, --cursor)
links leave <_id | share URL> Luovu jostakin sinulle jaetusta
links role <id> --email <e> --role viewer|editor Tee kutsumastasi henkilöstä katsoja tai muokkaaja
links unlock <_id | share URL> Syötä jaetun kohteen salasana, niin voit nähdä ja muokata sen kohdetta 30 minuutin ajan
links activity <id> Kuka muutti kohdetta ja miten
links reset-link <id> Uusi jako-URL; vanha linkdash.dev/s/-URL lakkaa toimimasta
links stats <id> Käyntien, latausten ja toistojen kokonaismäärät, myös varianttikohtaisesti, sekä indeksointibotit
links export Tulosta kaikki linkit CSV-muodossa (yksi rivi per variantti)
links import <file> Tuo URL- ja tekstirivit CSV
links variants list <id> Linkin variantit
links variants add <id> --name <n> Lisää variantti
links variants update <id> <name> Muuta varianttia
links variants remove <id> <name> Poista variantti
webhooks list Listaa webhook-päätepisteet (salaisuus peitetty)
webhooks get <id> Näytä yhden webhookin URL (salaisuus peitetty)
webhooks create --url <https> Lisää HTTPS-päätepiste (salaisuus näytetään kerran)
webhooks rotate <id> Luo uusi allekirjoitussalaisuus
webhooks delete <id> Poista webhook
domains list Listaa omat isäntänimet
domains add <host> Lisää isäntänimi (1 Free-paketissa)
domains connect <host> Domain Connect -käyttöönotto-URL tai null
domains verify <host> Tarkista DNS Unkeyn avulla
domains remove <host> Poista isäntänimi
-h, --help Ohje (pelkkä teksti)
-v, --version Versio

Jos sama slug on käytössä kahdessa omistajan verkkotunnuksessa, anna --domain.

Luonti- ja päivitysliput

Slug on linkin tunniste ja julkisen linkin julkinen polku. Nimi näkyy vain sinulle. Uudet linkit ovat rajattuja (katso Käyttöoikeudet ja jakaminen). Luonti ottaa täsmälleen yhden näistä: --url, --file tai --text (siitä tulee variantti main), --variant-lohkot (katso Variantit) tai --folder <name> (katso Kansiot).

Lippu Huomiot
--url <url> Kohde-URL
--file <path> Lähetettävä tiedosto (luonnissa, tai päivityksessä tiedoston sisällön korvaamiseen)
--text <text> Tekstikatkelma
--access <restricted|link|public> Kuka voi avata sen. Oletus restricted. Katso Käyttöoikeudet ja jakaminen
--reset-share-link Luo uusi jako-URL (vain päivitys)
--slug <id> Julkinen polku: a-z0-9 ja sisäiset väliviivat, 1–64 merkkiä
--name <label> Yksityinen nimi
--tag <tag> Toistettava. Pienet kirjaimet, ei pilkkuja. Enintään 20
--starts <when> Aktivoituu ajan 7d, 24h tai 30m kuluttua tai ISO-päivämääränä
--password <secret> Vaadi tämä salasana avaamiseen
--expires <when> Lakkaa toimimasta ajan 7d, 24h tai 30m kuluttua tai ISO-päivämääränä
--max-openings <n> Keskeytä näin monen avauksen jälkeen. Jätä pois, jos et halua rajaa
--domain <host> Käytä tätä isäntää lida.sh-osoitteen sijaan
--in <folder-id> Luo tämän kansion sisään (vain luonti; --in-domain <host>, jos kansion slug toistuu)
--status <active|paused> Keskeytä tai jatka (vain päivitys)
--sticky / --no-sticky Palaava kävijä saa saman variantin (oletuksena pysyvä)
--restart-split Arvo pysyvät osoitukset uudelleen (vain päivitys)
--forward-params / --no-forward-params Lisää kävijän kyselymerkkijono URL-variantteihin (oletuksena pois päältä). Katso Kyselyparametrien välittäminen
--variant <name> Aloita varianttilohko (vain luonti). Katso Variantit
--weight <n> --when <key=v1,v2> Varianttikohtaisia. Katso Variantit ja Kyselyparametrisäännöt
--preview-name <text> Julkisen esikatselun nimi
--preview-description <text> Julkisen esikatselun kuvaus
--preview-image <path> Julkisen esikatselun kuva
--utm-source --utm-medium --utm-campaign --utm-term --utm-content Vain URL-linkit
--clear-password --clear-expires --clear-starts --clear-tags --clear-preview --clear-name --clear-max-openings Vain päivitys

--status hyväksyy vain arvot active tai paused. Vanhentunut tila tulee --expires-lipusta. Ajastettu tila tulee --starts-lipusta. Julkinen haku palauttaa not-found-vastauksen alkamisaikaan asti. Kun --max-openings täyttyy, linkki keskeytyy; nosta lukua tai käytä --clear-max-openings, niin linkki toimii taas. Jo käytetyt avaukset pysyvät laskettuina, kunnes muutat rajaa tai poistat sen.

lida.sh-slugit ovat yhteisiä. Jos sana on jo varattu, lisää oma verkkotunnus ja yritä uudelleen --domain-lipulla. Oman verkkotunnuksen linkkiä ei julkaista lisäksi osoitteessa lida.sh.

Listausliput

Tulostaa yhden sivun, {items, cursor}: --limit on 1-100 (oletus 50); anna --cursor-lipulle edellisen sivun cursor-arvo, kunnes se on null. Sivulla voi olla vähemmän kohteita kuin --limit, jos suodatin ohittaa osan. --q täsmää kokonaisiin sanoihin, ja viimeinen sana toimii etuliitteenä (laun löytää example.com/launch); tulokset järjestetään osuvuuden mukaan. --in listaa yhden kansion, kansiot ensin; muuten uusimmat ensin.

Lippu Huomiot
--limit <n> Kohteita sivulla, 1-100 (oletus 50)
--cursor <c> Edellisen sivun cursor
--q <text> Hae sanoja nimestä, slugista, varianttien nimistä ja kohteista, tiedostonimistä, tekstikatkelmista ja tageista
--tag <tag> Suodata tagin mukaan
--kind <url|file|text|folder|group> Suodata tyypin mukaan (group = useita variantteja)
--status <status> active, paused, expired, scheduled tai mixed
--in <folder-id|root> Vain se, mikä on suoraan tässä kansiossa tai ylimmällä tasolla. Ilman tätä listataan kaikki

Variantit

Jokainen linkki on säiliö yhdelle tai useammalle variantille. Variantti on sisältö (URL, tiedosto tai teksti) sekä sen omat rajoitukset (--password, --starts, --expires, --max-openings), --weight ja valinnaiset kävijäehdot (--when). Ilman --variant-lippua linkillä on yksi variantti nimeltä main, ja jokainen yllä oleva komento on lyhennysmuoto sille. Kävijä saa yhden variantin: variantit, joiden --when täsmää, muodostavat valintajoukon (jos mikään ei täsmää, joukon muodostavat ehdottomat variantit), ja siitä tehdään painotettu valinta. Pysyvällä osoituksella (oletus) palaava kävijä saa saman variantin. Linkin omat rajoitukset menevät varianttien rajoitusten edelle. Varianttien nimet: pieniä kirjaimia, numeroita ja sisäisiä väliviivoja, 1–40 merkkiä, yksilöllinen linkin sisällä. Enintään 20 varianttia.

Linkin kind on variantin tyyppi, jos variantteja on yksi, ja group, jos niitä on useita. Linkin status on linkin rajoituksen tila, jos sellainen on asetettu (paused, scheduled, expired), muuten varianttien yhteinen tila ja muuten mixed. variantStatuses sisältää lukumäärät {active, paused, expired, scheduled}.

Luonti varianttilohkoilla

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> aloittaa varianttilohkon. Sen jälkeiset liput kuuluvat kyseiseen varianttiin seuraavaan --variant-lippuun asti: --url|--file|--text, --password, --starts, --expires, --max-openings, --weight <n>, --when <key=v1,v2> (toistettava), --utm-*. Linkin liput (--slug --name --tag --domain --preview-* --password --starts --expires --max-openings --sticky --no-sticky --forward-params) tulevat ennen ensimmäistä --variant-lippua.

Varianttien alikomennot

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> ottaa yhden lipuista --url, --file, --text sekä rajoitusliput, --weight, --when ja --utm-*. variants update <id> <name> ottaa liput --name <new>, sisällön, rajoitusliput, --status active|paused, --weight, --when, --clear-when, --clear-password, --clear-starts, --clear-expires ja --clear-max-openings. Linkillä on aina vähintään yksi variantti.

--when-avaimet

Avain JSON-kenttä Arvot
country countries ISO-2-koodit (DE, AT)
device devices mobile tablet desktop
os os windows macos android ios linux other
browser browsers edge chrome firefox safari other
language languages etuliitetäsmäys (de, en-us)
referrer referrerHosts isäntänimen loppuosa (twitter.com)

Jokaisen asetetun avaimen on täsmättävä. --when country=DE,AT --when device=mobile vastaa muotoa { "countries": ["DE","AT"], "devices": ["mobile"] }.

Kyselyparametrisäännöt

--when hyväksyy myös param:-sääntöjä kävijän kyselymerkkijonolle (lida.sh/promo?src=newsletter). Avaimissa kirjainkoolla on merkitystä, arvoja verrataan täsmälleen, ja variantilla voi olla enintään 10 sääntöä. Pilkut jakavat --when-arvon osiin, joten parametrin arvossa ei voi olla pilkkua; käytä listoissa merkkiä |.

Syntaksi JSON op Täsmää, kun
param:KEY=VALUE equals arvo on täsmälleen VALUE
param:KEY!=VALUE notEquals arvo on eri, tai avain puuttuu
param:KEY~=VALUE includes arvo sisältää merkkijonon VALUE
param:KEY^=VALUE startsWith arvo alkaa merkkijonolla VALUE
param:KEY$=VALUE endsWith arvo päättyy merkkijonoon VALUE
param:KEY=v1|v2 in arvo on jokin listan arvoista
param:KEY? tai param:KEY exists avain on olemassa
param:!KEY missing avain puuttuu
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-muoto: "when": { "params": [{ "key": "src", "op": "equals", "value": "newsletter" }] } (value jätetään pois, kun op on exists / missing). Parametrien arvot tarkistetaan avaushetkellä, eikä niitä koskaan tallenneta analytiikkaan.

Kyselyparametrien välittäminen

--forward-params / --no-forward-params komennoissa links create ja links update (linkkitasoinen, oletuksena pois päältä) lisää kävijän koko kyselymerkkijonon URL-variantteihin: lida.sh/promo?src=nl avaa osoitteen https://example.com/?src=nl. Kävijän arvot korvaavat tallennetut arvot, myös --utm-*-arvot. Tiedosto- ja tekstivariantit ohittavat asetuksen. Kyse on reitityksestä, ei käyttöoikeuksien hallinnasta: kuka tahansa voi lisätä parametreja. Parametrien arvoja ei tallenneta analytiikkaan. links get näyttää asetuksen kenttänä forwardParams.

Pysyvyys ja jaon uudelleenaloitus

links update <id> --sticky / --no-sticky määrittää, saako palaava kävijä saman variantin. links update <id> --restart-split arpoo pysyvät osoitukset uudelleen. links update -komennon sisältöliput toimivat vain yhden variantin linkeissä; muuten käytä komentoa links variants update <id> <name>.

Kansiot

Kansio on linkki, joka listaa siihen lisäämäsi kohteet. Katso sivulta Kansiot, miten julkinen sivu ja käyttöoikeudet toimivat.

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> asettaa kansion nimen (ei --name) ja hyväksyy liput --slug, --domain, --password, --starts, --expires, --max-openings, --tag, --preview-* ja --in. Sitä ei voi yhdistää lippuihin --url, --file, --text tai --variant. links move tulostaa {id, folder}. links copy säilyttää käyttöoikeustason, mutta kopio saa uuden jako-URL; ihmisiä ei kopioida. links delete kansiolle siirtää sen kohteet tasoa ylemmäs; --with-contents poistaa myös ne. Listauksen, haun ja luonnin riveillä on folder (sisältävän kansion slug tai null); kansiorivillä on lisäksi items.

Käyttöoikeudet ja jakaminen

Uudet linkit ja kansiot ovat restricted: niiden url on https://linkdash.dev/s/<token>, jonka voivat avata kirjautuneina vain sinä ja ne, joille jaat sen. --access link avaa tämän URL kaikille, joilla se on. --access public tarjoilee linkin sen lyhyessä URL-osoitteessa (lida.sh/<slug> tai oma verkkotunnuksesi). Käytä --access public -asetusta linkeille, jotka julkaiset avoimesti. Slug pysyy tunnisteena kaikissa komennoissa, ja sen lyhyt URL pysyy varattuna, vaikka linkki ei olisi julkinen. Katso koko malli sivulta Jakaminen ja käyttöoikeudet.

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
Komento Tulostaa
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 (ilman id) {items: [{id, name?, kind, access, url, people: [{email, accepted, invitedAt}]}], cursor}, viimeksi jaetut ensin
links shared {items: [{_id, _creationTime, kind, title?, status, hasPassword, access, url, itemCount?, sharedBy?, sharedAt}], cursor}, uusimmat ensin
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> (tai links update <id> --reset-share-link) {id, access, url}

--role editor tekee henkilöstä muokkaajan: hän voi muuttaa kohdetta ja nähdä sen tilastot, mutta ei salasanoja, slugia, verkkotunnusta, käyttöoikeuksia tai jakamista, eikä hän voi poistaa, siirtää tai kopioida kohdetta. Salasanalla suojattu kohde vaatii lisäksi ensin links unlock -komennon (30 minuuttia). Muokkaajat käyttävät _id tai jako-URL komennon links shared tulosteesta. Kaikki komennot hyväksyvät --domain <host> -lipun, kun slug toistuu. url komentojen create, get, list, update, copy ja share tulosteessa on jako-URL, ellei linkki ole julkinen, jolloin se on lyhyt URL; riveillä on access. Enintään 200 henkilöä kohdetta kohden, 50 sähköpostiosoitetta per komento ja 100 kutsusähköpostia tiliä kohden päivässä. Molemmat listat tulostavat yhden sivun: --limit on 1-100 (oletus 50); anna --cursor edelliseltä sivulta, kunnes cursor on null. links leave ottaa _id tai url komennon links shared tulosteesta; käyttöoikeus yläpuolella olevan jaetun kansion kautta säilyy. Jakaminen, jaon poistaminen, käyttöoikeuden muutos ja nollaus lasketaan kukin yhdeksi tapahtumaksi; poistuminen ei.

Tilastot

linkdash links stats <id> --last 24h

--last on kesto (24h, 7d). Oletus 24h. JSON sisältää kentät visits, downloads, plays, visitsInLast, countries, referrers, variants (varianttikohtaiset kokonaismäärät), visitors (jokaisella oma variant) ja crawlers ([{crawler, company, category, hits, lastSeen}]: botit ja linkkiesikatselut, jotka hakivat linkin; niitä ei koskaan lasketa käynneiksi).

CSV

Sarakkeet: slug,kind,name,variant,url,text,fileName,status,domain,tags,starts,expires,maxOpenings,weight,when,created,folder,access. Yksi rivi per variantti. kind, status, url, text, fileName, weight ja when (JSON-merkkijono) ovat varianttikohtaisia; loput ovat linkkikohtaisia ja toistuvat. folder on sen kansion slug, jossa linkki on. access on restricted, link tai public. Mukana ei ole salasanoja, jakotunnuksia eikä ihmisiä.

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

Tuonti ryhmittelee rivit slugin ja verkkotunnuksen mukaan. Ensimmäinen rivi luo linkin ja sen variantin; seuraavat rivit lisäävät variantteja. Olemassa olevalle linkille ensimmäinen rivi päivittää linkin kentät, ja sen jälkeen jokainen rivi päivittää samannimisen variantin, jos sellainen on olemassa, tai muuten lisää sen. Tiedostorivit, joilta puuttuu tiedoston sisältö, ohitetaan rivikohtaisella virheellä. Rivit, joissa kind = folder (ja name), luovat kansioita; folder-sarake sijoittaa kunkin linkin kansioonsa, kun kaikki rivit on luotu. Tyhjä access tekee uusista linkeistä rajattuja ja jättää olemassa olevat linkit ennalleen.

Esimerkkejä

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

Katso myös kansiot, jakaminen ja käyttöoikeudet, webhookit ja omat verkkotunnukset.

Oliko tästä sivusta apua?