Hoppa till innehåll
Help Center
Support

LabelGrids kommandoradsverktyg (CLI)

Uppdaterad juli 2026.

LabelGrid publicerar ett officiellt kommandoradsverktyg så att du kan arbeta med ditt konto direkt från terminalen eller från ett skript. Det är npm-paketet @labelgrid/cli, och när du installerar det läggs kommandot labelgrid till på din dator.

CLI:t är ett tunt skal runt LabelGrids publika API: samma validering och samma behörigheter. Varje kommando motsvarar ett API-anrop, så allt som API:et avvisar avvisar CLI:t på exakt samma sätt, och inget CLI-kommando kan göra något som din token inte har rätt till. Det täcker kommandogrupperna nedan snarare än varje endpoint som API:et publicerar; för ett hörn av API:et som ännu inte har något motsvarande kommando anropar du endpointen direkt. Vill du hellre arbeta på vanligt språk med en AI-assistent publicerar LabelGrid även en MCP-server byggd på samma API.

Vad du kan göra

Section titled “Vad du kan göra”

Kommandona är ordnade i grupper. Från terminalen kan du:

  • auth – logga in, logga ut, kontrollera vem du är inloggad som och återkalla en token
  • catalog – söka efter, visa, skapa, uppdatera och radera skivbolag, artister, låtskrivare, förlag, releaser och spår
  • release – validera en release, skicka in den för distribution, ta ner den, bekräfta granskning och hantera dess landningssida och kortlänk
  • upload – lägga till ljud, omslag, låttexter och rörligt omslag (varje typ accepterar bara sina tillåtna filändelser)
  • download, asset, license – hämta filer och hantera licenser
  • statement, transactions, royalties, analytics – hämta utdrag, transaktioner, royaltyuppdelningar och streaminganalys
  • review – visa granskningsanmärkningar, läsa kvalitetsrapporter och lägga till noteringar
  • webhook – registrera och hantera webhooks för asynkrona aviseringar
  • beatport – hantera aktivering av Beatport

Vad du behöver

Section titled “Vad du behöver”
  1. Ett LabelGrid-konto med API-åtkomst. API-åtkomst ingår i LabelGrids API-planer; se API-översikt för hur du får den.
  2. En API-token. Generera en i din LabelGrid-dashboard under Profil → API-tokens.
  3. Node.js 20 eller senare på datorn där du kör CLI:t.

Installera

Section titled “Installera”

Installera CLI:t globalt med npm:

Terminal window
npm install -g @labelgrid/cli

Det lägger till kommandot labelgrid. Kontrollera att det fungerade med:

Terminal window
labelgrid --version

Autentisering

Section titled “Autentisering”

CLI:t behöver din API-token. Det letar efter en på tre ställen, i den här ordningen:

  1. Miljövariabeln LABELGRID_API_TOKEN – bäst för skript och CI, där värdet kommer från din CI-leverantörs hemlighetshantering.
  2. En sparad inloggningsuppgift som du lagrar en gång med labelgrid auth login. På macOS sparas den i din nyckelring; på andra system sparas den i en behörighetsbegränsad fil under ~/.config/labelgrid/.
  3. Flaggan --token på ett enskilt kommando – den sista utvägen.

På din egen dator är det säkraste att spara token en gång. Kör labelgrid auth login utan argument, så ber den dig klistra in token med dold inmatning, vilket gör att värdet aldrig syns på skärmen eller i terminalens historik:

Terminal window
labelgrid auth login

Varje efterföljande kommando återanvänder den sparade inloggningsuppgiften, så du behöver aldrig skriva in token igen:

Terminal window
labelgrid auth whoami

För obevakad uppsättning där ingenting kan fråga skickar du token till labelgrid auth login från en hemlighetshanterare via en pipe i stället för att skicka den som ett argument:

Terminal window
my-secret-manager read labelgrid-token | labelgrid auth login

CLI:t skriver aldrig ut tokenvärden. För att stoppa åtkomsten loggar du ut med labelgrid auth logout, vilket tar bort den sparade inloggningsuppgiften från den datorn, eller återkallar token i din dashboard, vilket omedelbart gör att just den token slutar fungera överallt. Övriga tokens på ditt konto fortsätter att fungera; återkalla varje token som du vill ta ur bruk.

Utdata och exitkoder

Section titled “Utdata och exitkoder”

Som standard skriver CLI:t ut rent, läsbart resultat. För skript lägger du till --json på vilket kommando som helst, så skrivs det råa API-svaret ut och du kan skicka det vidare till andra verktyg:

Terminal window
labelgrid catalog search releases --query "summer" --json

Kommandona sätter standardiserade exitkoder så att dina skript kan reagera på resultatet:

ExitkodBetydelse
0Lyckades
1API-fel (förfrågan nådde LabelGrid och avvisades)
2Användningsfel (ett misstag i själva kommandot)

Säkerhet

Section titled “Säkerhet”

Slutgiltiga och destruktiva kommandon ber dig bekräfta innan något skickas. Att skicka in en release för distribution, ta ner en release, bekräfta granskning, radera katalogposter och aktivera Beatport kräver alla att du skriver y för att bekräfta innan CLI:t gör något API-anrop.

För automatisering där ingen sitter vid tangentbordet lägger du till --yes för att hoppa över frågan:

Terminal window
labelgrid release distribute REL123 --yes

Alla kontoskydd, alltså validering, plangränser och hastighetsbegränsningar, upprätthålls av LabelGrids servrar, så CLI:t kan inte kringgå dem oavsett hur du kör det.

Felsökning

Section titled “Felsökning”
  • command not found: labelgrid – den globala installationen blev inte klar eller ligger inte i din PATH. Kör npm install -g @labelgrid/cli igen och bekräfta Node.js 20 eller senare med node --version.
  • Token ogiltig eller avvisad – skapa om token i din dashboard under Profil → API-tokens och spara den sedan igen med labelgrid auth login.
  • Du ser ingen sida för “API-tokens” – ditt konto har ännu inte API-åtkomst. Se API-översikt för hur du aktiverar den.
  • Ett kommando misslyckas i ett skript – kontrollera exitkoden (1 är ett API-fel, 2 är ett användningsfel) och kör samma kommando igen med --json för att läsa hela svaret.

Vanliga frågor

Section titled “Vanliga frågor”

”Har LabelGrid ett kommandoradsverktyg?”

Section titled “”Har LabelGrid ett kommandoradsverktyg?””

Ja. LabelGrid publicerar ett officiellt CLI som npm-paketet @labelgrid/cli. Installera det med npm install -g @labelgrid/cli, så läggs kommandot labelgrid till i din terminal. Det kräver Node.js 20 eller senare och är ett tunt skal runt LabelGrids publika API.

”Vad kan jag göra med det?”

Section titled “”Vad kan jag göra med det?””

Logga in och hantera tokens; söka efter, visa, skapa, uppdatera och radera skivbolag, artister, låtskrivare, förlag, releaser och spår; ladda upp ljud, omslag, låttexter och rörligt omslag; validera releaser, skicka in dem för distribution och ta ner dem; hämta utdrag, transaktioner, royalties och streaminganalys; visa granskningsanmärkningar och kvalitetsrapporter; hantera webhooks; och hantera aktivering av Beatport.

”Hur autentiserar jag CLI:t?”

Section titled “”Hur autentiserar jag CLI:t?””

Med en LabelGrid API-token. CLI:t letar efter den på tre ställen, i tur och ordning: miljövariabeln LABELGRID_API_TOKEN, sedan en inloggningsuppgift sparad med labelgrid auth login, och sedan flaggan --token. Använd helst labelgrid auth login – den ber dig ange token med dold inmatning, så att värdet aldrig når terminalens historik eller processlistan. CLI:t skriver aldrig ut tokenvärden.

”Behöver jag en API-plan?”

Section titled “”Behöver jag en API-plan?””

Ja. CLI:t ansluter via LabelGrids publika API, så ditt konto behöver API-åtkomst, vilket ingår i LabelGrids API-planer. Se API-översikt för hur du får åtkomst.

”Vad skiljer CLI:t från MCP-servern?”

Section titled “”Vad skiljer CLI:t från MCP-servern?””

Båda är officiella LabelGrid-verktyg på samma publika API. CLI:t är till för din terminal och dina skript; MCP-servern är till för AI-assistenter som Claude och Cursor, som gör API-anropen åt dig utifrån vanligt språk. Använd det som passar ditt arbetssätt, eller båda.

Relaterat

Section titled “Relaterat”

Behöver du hjälp?

Section titled “Behöver du hjälp?”

Har du frågor om CLI:t? Kontakta vårt supportteam.

Använder du inte LabelGrid än?

Allt du just läste om finns på vår plattform.

Se vad LabelGrid kan göra →