Ugrás a tartalomra
LinkdashLinkdash
Magyar
Esc
↑↓navigálás↵megnyitás⌘Jelőnézet
Ezen az oldalon

CLI

Telepítsd a linkdash-cli csomagot npm-ről, majd futtasd a `linkdash` parancsot. A sikeres parancsok JSON-t írnak az stdout-ra. A súgó és a hibák egyszerű szövegként jelennek meg az stderr-en.

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

Az npm-csomag neve linkdash-cli. A parancs neve linkdash.

HTTP-megfelelő: HTTP API. MCP: MCP. Agent skill: Agent skill. Árazás: Árazás. Sima markdown: cli.md.

Nincs --json kapcsoló. Hiba esetén a kilépési kód 1.

Hitelesítés

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

Még nincs fiókod? Az auth create megnyitja a https://linkdash.dev/sign-up oldalt, majd a CLI-kóddal visszavisz a https://linkdash.dev/device oldalra, hogy jóváhagyhasd. Van már fiókod? Az auth login a /device oldalt nyitja meg. Headless környezetben állítsd a LINKDASH_TOKEN változót egy olyan session tokenre, amelyet az auth create vagy az auth login adott. Ne találj ki tokeneket.

Session-fájl: ~/.config/linkdash/config.json (0600-as jogosultsággal).

A CLI nem tudja módosítani az e-mail-címet, a jelszót vagy a számlázást. Ehhez küldd a felhasználót a dashboardra. API-kulcsok (HTTP és MCP): API-kulcsok.

Parancsok

linkdash <command> [options]
Parancs Mit csinál
auth create Regisztráció böngészőben, majd az eszköz jóváhagyása
auth login Bejelentkezés böngészőben, eszközkóddal
auth logout A tárolt session törlése
auth whoami A bejelentkezett fiók adatai JSON-ként
links list Linkek és mappák listázása oldalanként (--limit, --cursor)
links get <id> Egy link lekérése
links create --url <url> Rövid link egy URL-ből
links create --file <path> Fájl feltöltése és link kérése hozzá
links create --text <text> Szövegrészlet tárolása
links create --folder <name> Mappa létrehozása
links create --variant <name> … Link több variánssal (split / targeting)
links update <id> A cél, a fájl, a jelszó, a lejárat, a domain, az állapot, a sticky beállítás vagy a továbbított paraméterek módosítása
links move <id> --in <folder-id> Link vagy mappa áthelyezése egy mappába (--root a legfelső szinthez)
links copy <id> Másolat készítése új sluggal, ugyanabban a mappában
links delete <id> Link törlése (egy mappa elemei egy szinttel feljebb kerülnek; a --with-contents törli őket)
links share <id> --email <email> Megosztás másokkal e-mail-cím alapján (ismételd a --email-t; a --role editor megengedi nekik a módosítást; minden új személy meghívó e-mailt kap)
links unshare <id> --email <email> Valaki hozzáférésének visszavonása
links shares [id] Kik nyithatják meg rajtad kívül, a felette lévő mappán keresztül is. Id nélkül: minden, amihez embereket hívtál meg, oldalanként (--limit, --cursor)
links shared Amit mások osztottak meg veled, oldalanként (--limit, --cursor)
links leave <_id | share URL> Kilépés egy veled megosztott elemből
links role <id> --email <e> --role viewer|editor Egy általad meghívott személy megtekintővé vagy szerkesztővé tétele
links unlock <_id | share URL> Egy megosztott elem jelszavának megadása, hogy 30 percig lásd és szerkeszd a célját
links activity <id> Ki és hogyan módosított egy elemet
links reset-link <id> Új megosztási URL; a régi linkdash.dev/s/ URL megszűnik működni
links stats <id> Látogatások, letöltések és lejátszások összesítése, variánsonként is, plusz crawlerek
links export Az összes link kiírása CSV-ként (variánsonként egy sor)
links import <file> URL- és szövegsorok importálása CSV-ből
links variants list <id> Egy link variánsai
links variants add <id> --name <n> Variáns hozzáadása
links variants update <id> <name> Variáns módosítása
links variants remove <id> <name> Variáns eltávolítása
webhooks list Webhook-végpontok listázása (maszkolt secrettel)
webhooks get <id> Egy webhook URL megjelenítése (maszkolt secrettel)
webhooks create --url <https> HTTPS-végpont hozzáadása (a secret csak egyszer jelenik meg)
webhooks rotate <id> Új aláíró secret kiadása
webhooks delete <id> Webhook eltávolítása
domains list Egyedi hostnevek listázása
domains add <host> Hostnév hozzáadása (Free csomagban 1)
domains connect <host> Domain Connect alkalmazási URL, vagy null
domains verify <host> DNS ellenőrzése az Unkey-vel
domains remove <host> Hostnév eltávolítása
-h, --help Súgó (egyszerű szöveg)
-v, --version Verzió

Ha ugyanaz a slug a tulajdonos két domainjén is létezik, add meg a --domain kapcsolót.

Létrehozási és módosítási kapcsolók

A slug a link azonosítója, nyilvános link esetén pedig a nyilvános elérési útja is. A nevet csak te látod. Az új linkek korlátozottak (lásd Hozzáférés és megosztás). A create a következők közül pontosan egyet vár: --url, --file vagy --text (ebből lesz a main variáns), --variant blokkok (lásd Variánsok), vagy --folder <name> (lásd Mappák).

Kapcsoló Megjegyzés
--url <url> Cél-URL
--file <path> Feltöltendő fájl (létrehozáskor, illetve módosításkor a fájl tartalmának cseréje)
--text <text> Szövegrészlet
--access <restricted|link|public> Ki nyithatja meg. Alapértelmezés: restricted. Lásd Hozzáférés és megosztás
--reset-share-link Új megosztási URL kiadása (csak módosításkor)
--slug <id> Nyilvános elérési út: a-z0-9 és belső kötőjelek, 1–64 karakter
--name <label> Privát címke
--tag <tag> Ismételhető. Kisbetűs, vessző nélkül. Max. 20
--starts <when> Élesedés 7d, 24h, 30m után, vagy egy ISO-dátumkor
--password <secret> A megnyitáshoz ez a jelszó kell
--expires <when> A kiszolgálás leállítása 7d, 24h, 30m után, vagy egy ISO-dátumkor
--max-openings <n> Szüneteltetés ennyi megnyitás után. Korlátlan megnyitáshoz hagyd el
--domain <host> Kiszolgálás ezen a hoston a lida.sh helyett
--in <folder-id> Létrehozás ebben a mappában (csak létrehozáskor; --in-domain <host>, ha a mappa slugja ismétlődik)
--status <active|paused> Szüneteltetés vagy folytatás (csak módosításkor)
--sticky / --no-sticky A visszatérő látogató ugyanazt a variánst kapja (alapból sticky)
--restart-split A sticky hozzárendelések újrakeverése (csak módosításkor)
--forward-params / --no-forward-params A látogató query stringjének hozzáfűzése az URL-variánsokhoz (alapból ki van kapcsolva). Lásd Query paraméterek továbbítása
--variant <name> Variánsblokk indítása (csak létrehozáskor). Lásd Variánsok
--weight <n> --when <key=v1,v2> Variánsonként. Lásd Variánsok és Query paraméter szabályok
--preview-name <text> Nyilvános előnézeti (unfurl) név
--preview-description <text> Nyilvános előnézeti (unfurl) leírás
--preview-image <path> Nyilvános előnézeti (unfurl) kép
--utm-source --utm-medium --utm-campaign --utm-term --utm-content Csak URL-linkekhez
--clear-password --clear-expires --clear-starts --clear-tags --clear-preview --clear-name --clear-max-openings Csak módosításkor

A --status csak active vagy paused értéket fogad el. A lejárt állapotot a --expires, az ütemezettet a --starts határozza meg. A kezdésig a nyilvános feloldás not-found eredményt ad. Ha a link eléri a --max-openings értéket, szünetel; ha újra ki akarod szolgálni, növeld a számot, vagy használd a --clear-max-openings kapcsolót. A már felhasznált megnyitások addig számítanak, amíg nem módosítod vagy nem törlöd a korlátot.

A lida.sh slugok közösek. Ha egy szó már foglalt, adj hozzá egy egyedi domaint, és próbáld újra a --domain kapcsolóval. Egy saját márkás domainen lévő link nem jelenik meg a lida.sh-n is.

Listázási kapcsolók

Egy oldalt ír ki, {items, cursor} formában: a --limit 1-100 (alapértelmezés 50); add át a --cursor-nak az előző oldal cursor értékét, amíg az null nem lesz. Egy oldalon kevesebb elem is lehet, mint a --limit, ha egy szűrő kihagy néhányat. A --q egész szavakra illeszkedik, az utolsót prefixként kezeli (a laun megtalálja az example.com/launch-ot), és relevancia szerint rendez; a --in egy mappát listáz, elöl a mappákkal; egyébként a legújabbak kerülnek előre.

Kapcsoló Megjegyzés
--limit <n> Elemek száma oldalanként, 1-100 (alapértelmezés 50)
--cursor <c> Az előző oldal cursor értéke
--q <text> Keresés a névben, a slugban, a variánsnevekben és -célokban, a fájlnevekben, a szövegrészletekben és a tagekben
--tag <tag> Szűrés tag szerint
--kind <url|file|text|folder|group> Szűrés típus szerint (group = több variáns)
--status <status> active, paused, expired, scheduled vagy mixed
--in <folder-id|root> Csak ami közvetlenül ebben a mappában vagy a legfelső szinten van. Nélküle minden listázódik

Variánsok

Minden link egy vagy több variánst tartalmaz. Egy variáns a tartalomból (URL, fájl vagy szöveg), a saját korlátaiból (--password, --starts, --expires, --max-openings), egy --weight súlyból és opcionális látogatói feltételekből (--when) áll. --variant nélkül a linknek egyetlen, main nevű variánsa van, és a fenti parancsok mind erre vonatkozó rövidítések. A látogató egy variánst kap: azokból a variánsokból áll össze a készlet, amelyeknek a --when feltétele illeszkedik (ha egyik sem illeszkedik, akkor a feltétel nélküliekből), majd súlyozott választás következik. Sticky hozzárendeléssel (ez az alapértelmezés) a visszatérő látogató ugyanazt a variánst kapja. A link saját korlátai elsőbbséget élveznek a variánsokéval szemben. Variánsnevek: kisbetűk, számjegyek, belső kötőjelek, 1–40 karakter, linkenként egyedi. Max. 20 variáns.

A link kind értéke egy variánsnál a variáns típusa, többnél group. A link status értéke a link korlátja, ha be van állítva (paused, scheduled, expired), ha nincs, a variánsok közös állapota, ha pedig az sincs, mixed. A variantStatuses a {active, paused, expired, scheduled} állapotok darabszámát adja meg.

Létrehozás variánsblokkokkal

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

A --variant <name> egy variánsblokkot indít. Az utána következő kapcsolók a következő --variant-ig ehhez a variánshoz tartoznak: --url|--file|--text, --password, --starts, --expires, --max-openings, --weight <n>, --when <key=v1,v2> (ismételhető), --utm-*. A linkszintű kapcsolók (--slug --name --tag --domain --preview-* --password --starts --expires --max-openings --sticky --no-sticky --forward-params) az első --variant elé kerülnek.

Variáns-alparancsok

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

A variants add <id> --name <n> a --url, --file, --text közül egyet vár, továbbá korlátozó kapcsolókat, valamint --weight, --when, --utm-* kapcsolókat. A variants update <id> <name> a következőket fogadja: --name <new>, tartalom, korlátozó kapcsolók, --status active|paused, --weight, --when, --clear-when, --clear-password, --clear-starts, --clear-expires, --clear-max-openings. Egy linknek mindig legalább egy variánsa marad.

--when kulcsok

Kulcs JSON-mező Értékek
country countries ISO-2 kódok (DE, AT)
device devices mobile tablet desktop
os os windows macos android ios linux other
browser browsers edge chrome firefox safari other
language languages prefix-egyezés (de, en-us)
referrer referrerHosts host-utótag (twitter.com)

Minden megadott kulcsnak illeszkednie kell. A --when country=DE,AT --when device=mobile jelentése: { "countries": ["DE","AT"], "devices": ["mobile"] }.

Query paraméter szabályok

A --when param: szabályokat is elfogad a látogató query stringjére (lida.sh/promo?src=newsletter). A kulcsok kis- és nagybetű-érzékenyek, az értékeket pontos egyezéssel hasonlítja össze, variánsonként legfeljebb 10 szabály adható meg. A vessző tagolja a --when értékét, ezért egy paraméterérték nem tartalmazhat vesszőt; listákhoz használd a | jelet.

Szintaxis JSON op Mikor illeszkedik
param:KEY=VALUE equals az érték pontosan VALUE
param:KEY!=VALUE notEquals az érték eltér, vagy a kulcs hiányzik
param:KEY~=VALUE includes az érték tartalmazza a VALUE-t
param:KEY^=VALUE startsWith az érték VALUE-val kezdődik
param:KEY$=VALUE endsWith az érték VALUE-ra végződik
param:KEY=v1|v2 in az érték a lista egyik eleme
param:KEY? vagy param:KEY exists a kulcs jelen van
param:!KEY missing a kulcs hiányzik
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-forma: "when": { "params": [{ "key": "src", "op": "equals", "value": "newsletter" }] } (az exists / missing esetén a value elmarad). A paraméterértékek illesztése megnyitáskor történik, és az analitika sosem tárolja őket.

Query paraméterek továbbítása

A links create és a links update --forward-params / --no-forward-params kapcsolója (linkszintű, alapból ki van kapcsolva) a látogató teljes query stringjét hozzáfűzi az URL-variánsokhoz: a lida.sh/promo?src=nl a https://example.com/?src=nl címet nyitja meg. A látogató értékei felülírják a tárolt értékeket, a --utm-* értékeket is beleértve. A fájl- és szövegvariánsok figyelmen kívül hagyják. Ez routing, nem hozzáférés-szabályozás: bárki hozzáadhat paramétereket. Az analitika nem tárolja a paraméterértékeket. A links get forwardParams néven mutatja.

Sticky és a split újraindítása

A links update <id> --sticky / --no-sticky azt állítja be, hogy a visszatérő látogató ugyanazt a variánst kapja-e. A links update <id> --restart-split újrakeveri a sticky hozzárendeléseket. A links update tartalomkapcsolói csak egyvariánsos linkeknél működnek; egyébként használd a links variants update <id> <name> parancsot.

Mappák

A mappa egy olyan link, amely listázza a beletett elemeket. A nyilvános oldal és a hozzáférés működéséről a Mappák oldalon olvashatsz.

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

A --folder <name> a mappa nevét állítja be (nem a --name), és a következő kapcsolókat fogadja: --slug, --domain, --password, --starts, --expires, --max-openings, --tag, --preview-* és --in. Nem kombinálható a --url, --file, --text vagy --variant kapcsolóval. A links move kimenete {id, folder}. A links copy megtartja a hozzáférési szintet, de új megosztási URL-t kap; a személyek nem másolódnak át. Mappára futtatva a links delete az elemeket egy szinttel feljebb helyezi; a --with-contents azokat is törli. A list, get és create sorai tartalmazzák a folder mezőt (a tartalmazó mappa slugját, vagy null-t); a mappák sorai az items mezőt is.

Hozzáférés és megosztás

Az új linkek és mappák restricted hozzáférésűek: az url értékük https://linkdash.dev/s/<token>, amelyet csak te és azok nyithatnak meg bejelentkezve, akikkel megosztod. A --access link bárki számára megnyitja ezt az URL-t, akinél megvan. A --access public a rövid URL-jén szolgálja ki a linket (lida.sh/<slug> vagy a saját domained). A nyilvánosan közzétett linkekhez használd a --access public kapcsolót. A slug minden parancsnál azonosító marad, a rövid URL-je pedig foglalt marad, amíg a link nem nyilvános. A teljes modellt a Megosztás és hozzáférés oldalon találod.

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
Parancs Kimenet
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 (id nélkül) {items: [{id, name?, kind, access, url, people: [{email, accepted, invitedAt}]}], cursor}, a legutóbb megosztottak elöl
links shared {items: [{_id, _creationTime, kind, title?, status, hasPassword, access, url, itemCount?, sharedBy?, sharedAt}], cursor}, a legújabbak elöl
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> (vagy links update <id> --reset-share-link) {id, access, url}

A --role editor szerkesztővé tesz valakit: módosíthatja az elemet és láthatja a statisztikáit, de a jelszavakhoz, a slughoz, a domainhez, a hozzáféréshez és a megosztáshoz nem nyúlhat, nem törölheti, nem helyezheti át és nem másolhatja, egy jelszóval védett célhoz pedig előbb links unlock kell neki (30 percre). A szerkesztők a links shared kimenetéből kapott _id-t vagy megosztási URL-t használják. Ha a slug ismétlődik, mindegyik parancs elfogadja a --domain <host> kapcsolót. A create, get, list, update, copy és share kimenetében az url a megosztási URL, kivéve ha a link nyilvános, mert akkor a rövid URL; a sorok tartalmazzák az access mezőt. Elemenként legfeljebb 200 személy, hívásonként 50 e-mail-cím, fiókonként naponta 100 meghívó e-mail. A két lista egy oldalt ír ki: a --limit 1-100 (alapértelmezés 50); add meg a --cursor-nak az előző oldal értékét, amíg a cursor null nem lesz. A links leave a links shared kimenetéből kapott _id-t vagy url-t fogadja; ha egy feljebb lévő megosztott mappán keresztül is hozzáférsz, az megmarad. A megosztás, a megosztás visszavonása, a hozzáférés módosítása és a link visszaállítása egy-egy eseménynek számít; a kilépés nem.

Statisztikák

linkdash links stats <id> --last 24h

A --last egy időtartam (24h, 7d). Alapértelmezés: 24h. A JSON a következőket tartalmazza: visits, downloads, plays, visitsInLast, countries, referrers, variants (variánsonkénti összesítések), visitors (mindegyik variant mezővel) és crawlers ([{crawler, company, category, hits, lastSeen}]: botok és linkelőnézetek, amelyek lekérték a linket; ezek sosem számítanak látogatásnak).

CSV

Oszlopok: slug,kind,name,variant,url,text,fileName,status,domain,tags,starts,expires,maxOpenings,weight,when,created,folder,access. Variánsonként egy sor. A kind, status, url, text, fileName, weight és when (JSON-string) variánsonként szerepel; a többi linkszintű, és soronként ismétlődik. A folder annak a mappának a slugja, amelyben a link van. Az access értéke restricted, link vagy public. Jelszavak, megosztási tokenek és személyek nem kerülnek bele.

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

Az import slug + domain alapján csoportosítja a sorokat. Az első sor létrehozza a linket a variánsával; a további sorok variánsokat adnak hozzá. Meglévő linknél az első sor a link mezőit frissíti, majd minden sor név alapján frissíti a variánst, ha az létezik, különben hozzáadja. A tartalom nélküli fájlsorokat soronkénti hibával kihagyja. A kind = folder sorok (name értékkel) mappákat hoznak létre; a folder oszlop alapján minden link a saját mappájába kerül, miután az összes sor létrejött. Üres access esetén az új linkek korlátozottak lesznek, a meglévők pedig változatlanok maradnak.

Példák

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

Lásd még: mappák, megosztás és hozzáférés, webhookok és egyedi domainek.

Hasznos volt ez az oldal?