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.

