API-nycklar

En API-nyckel låter ett skript eller ett annat verktyg använda REST API för ert workspace.

En nyckel tillhör workspacet, inte personen som skapade den. Den fortsätter fungera när någon slutar, och det den gör syns som API · namn i kommentarer, aktivitet och aktivitetsloggen. En nyckel är ingen medlem: den syns aldrig i medlemslistor eller väljare och tar ingen licens.

Skapa en nyckel

Gå till Inställningar → Integrationer → REST API och klicka på Ny nyckel. Du behöver behörigheten Koppla integrationer och regler.
Ge den ett namn som säger var den används, till exempel “n8n” eller “Rapporter”.
Välj en roll. Nyckeln får göra det rollen får, och aldrig mer än du själv. Välj en roll med få behörigheter när nyckeln bara behöver lite.
Välj åtkomst:
- Bara läsa: kan hämta projekt, ärenden och kommentarer men inte ändra något.
- Läsa och skriva: kan också skapa och ändra ärenden och kommentera, inom rollens behörigheter.
Välj Projekt: Alla projekt som rollen ser, eller Bara valda. En nyckel som är begränsad till vissa projekt ser inget annat.
Välj när den slutar gälla: om 30, 90 eller 365 dagar, eller aldrig. 90 dagar är förvalt. En nyckel som gått ut slutar fungera av sig själv.
Klicka på Skapa nyckel och kopiera nyckeln nu. Den visas bara en gång; spara den i en lösenordshanterare.

Använd den

Skicka nyckeln i headern Authorization:

curl https://work.nod3.se/api/v1/items?project=WEB \
  -H "Authorization: Bearer w3_..."

Varje nyckel får göra 120 anrop per minut. API-referensen finns på engelska.

Återkalla en nyckel

Klicka på Återkalla vid nyckeln. Allt som använder den slutar fungera direkt. Dess namn syns fortfarande på det den gjort. Att skapa och återkalla nycklar syns i aktivitetsloggen.

En roll som en nyckel använder kan inte tas bort förrän nyckeln är återkallad.

Personliga API-nycklar

Ett workspace kan också låta personer skapa personliga API-nycklar under Inställningar → Mina integrationer → Mina API-nycklar. En personlig nyckel skiljer sig från nycklarna ovan:

Den agerar som du: din roll, dina behörigheter och bara det du får se. Det den gör syns under ditt namn. Ändras din roll ändras också vad nyckeln får göra, och den slutar fungera om du lämnar workspacet.
Det finns ingen roll att välja. Du väljer namn, Bara läsa eller Läsa och skriva, Alla projekt eller Bara valda (bland projekten du ser), och ett slutdatum om 30, 90 eller 365 dagar. En personlig nyckel slutar alltid gälla. Begränsa en nyckel till de projekt ett skript behöver: då ser och ändrar den inget annat, även där du själv skulle kunna.
Du kan ha högst 10 samtidigt i varje workspace. Den visas en gång, precis som andra nycklar.

Personliga API-nycklar är avstängda tills någon med behörigheten Koppla integrationer och regler slår på dem för vissa roller under Inställningar → Integrationer → Regler (se Vem ser vilka inställningar). Stängs de av igen slutar befintliga personliga nycklar fungera direkt, och fungerar igen när det slås på. Admins ser vem som har personliga nycklar, och när de senast användes, under Kopplat av personer, och kan återkalla dem där. Själva nyckeln visas aldrig igen.