Vad är ett API?
Ett API kan beskrivas som ett sätt för två system att kommunicera med varandra.
I stället för att någon manuellt loggar in i Classic och söker fram uppgifter kan ett externt system hämta den information som önskas automatiskt. Det kan till exempel handla om att visa aktuella styrande dokument, rutiner eller instruktioner i ett annat system, eller att använda dokumentinformation i uppföljning, rapportering eller interna dashboards.
Läs-API för Dokument är endast avsett för läsning. Det innebär att API:t kan användas för att hämta information, men inte för att skapa, ändra, godkänna eller radera dokument i Classic.
Vad kan läs-API för Dokument användas till?
Läs-API för Dokument kan till exempel användas för att:
- söka och lista publicerade dokument utifrån exempelvis dokumentnummer, namn, kategori eller metadata
- hämta dokumentinnehåll och metadata
- hämta dokumentbilagor
- hämta dokument i PDF format
Ett exempel kan vara att ett annat system behöver visa aktuell information från ett godkänt och publicerat dokument i Classic, utan att användaren först behöver söka fram dokumentet manuellt i systemet. Det kan till exempel vara relevant om medarbetare ska kunna ta del av den senaste versionen av en policy, rutin eller instruktion direkt i ett intranät, produktionssystem eller en intern portal. På så sätt kan informationen visas där den behövs i det dagliga arbetet, samtidigt som den fortfarande hanteras och underhålls i Classic.
Vilka dokument omfattas?
Läs-API för Dokument ger åtkomst till alla publicerade dokument i ert dokumentsystem. Det innebär att API:t kan användas för att läsa information från dokument som är publicerade och tillgängliga i Dokument.
Utkast omfattas inte. API:t är alltså inte avsett för att läsa dokument som fortfarande är under arbete och ännu inte har publicerats.
Tillgängligt för test augusti 2026
Läs-API för Dokument blir tillgängligt för test under augusti 2026. Ni kan redan nu anmäla ert intresse för att vara med och utvärdera funktionen. När testperioden närmar sig, eller när det är aktuellt att aktivera funktionen för er, återkommer vi med mer information om nästa steg. Testperioden är kostnadsfri. Prissättningen för den färdiga funktionen är ännu inte fastställd.
Att anmäla intresse innebär inte att API:t aktiveras direkt. Aktivering sker först när funktionen är tillgänglig för test och efter överenskommelse med AM System.
En tid efter att ni har kommit igång med läs-API:t kontaktar vi er för en kort uppföljning. Syftet är att förstå hur lösningen används, vilket värde den skapar och om det finns möjligheter att förenkla arbetssätt, minska manuell hantering eller öka effektiviteten i era flöden.
Aktivering och API-nyckel
När läs-API för Dokument har aktiverats för er miljö behöver en användare hos er med administrativa rättigheter i Classic skapa en API-nyckel innan ni kan göra ert första anrop. Detta behöver normalt bara göras en gång, men kan upprepas vid behov, till exempel om en nyckel behöver bytas ut av säkerhetsskäl.
API-nyckel för dokument kan skapas i Classic av en administratör genom att gå till: Administratör » Inställningar » API » Dokument. Av säkerhetsskäl visas nyckeln bara vid skapandet, så kopiera den och förvara den på en säker plats för framtida användning. Om ni skulle tappa bort nyckeln, eller om ni av säkerhetsskäl vill byta ut den, behöver ni skapa en ny nyckel. När en ny nyckel genereras blir den tidigare nyckeln obrukbar, vilket innebär att alla integrationer som använder den gamla nyckeln måste uppdateras med den nya. Därför är det viktigt att ni har en tydlig rutin för nyckelhantering, till exempel att lagra nyckeln på en säker plats med begränsad åtkomst och undvika osäkra kanaler.
När en nyckel skapas skickas en avisering till övriga administratörer i er miljö om att en API-nyckel har genererats. Syftet är att skapa transparens och tydligt visa att det nu finns en API‑nyckel som ger åtkomst till alla publicerade dokument via API:t. Detta underlättar intern kontroll och hjälper er att upprätthålla en hög säkerhetsnivå kring åtkomst till dokumentinformationen.
Det är även möjligt att inaktivera en API-nyckel. Detta kan till exempel vara aktuellt om nyckeln inte längre används, om ni misstänker att den har spridits till obehöriga eller om ni av säkerhetsskäl vill begränsa åtkomsten till dokumentsystemet under en period. När en API-nyckel inaktiveras slutar alla integrationer och externa system som använder nyckeln omedelbart att kunna hämta information via läs-API:t för Dokument. Inaktivering är därför ett effektivt sätt att snabbt stoppa oönskad trafik eller tillfälligt pausa en integration, men bör alltid planeras och kommuniceras internt så att berörda systemägare och leverantörer hinner anpassa sina lösningar.
Viktigt om API-nyckeln
Eftersom API-nyckeln ger bred åtkomst är det viktigt att ni internt klargör vem som ansvarar för nyckeln, var den får lagras och vilka system som får använda den.
- API-nyckeln bör endast delas med personer eller system som är behöriga att använda den.
- API-nyckeln bör behandlas som en hemlig uppgift, på samma sätt som ett användarnamn med tillhörande lösenord.
- API-nyckeln bör inte skickas i osäkra kanaler eller sparas på platser där obehöriga kan komma åt den.
- API-nyckeln bör endast användas i de system och integrationer där den faktiskt behövs.
- Om ni misstänker att API-nyckeln har spridits till obehöriga bör ni skapa en ny nyckel (vilket gör den föregående nyckeln obrukbar) eller inaktivera nyckeln.
Kom igång med API-anrop
När API-nyckeln har skapats kan den användas av den integration eller det externa system som ska kommunicera med Classic.
Den tekniska lösningen behöver normalt hanteras av någon hos er som arbetar med IT, systemintegration eller utveckling. Det kan till exempel vara en intern IT-avdelning, en systemleverantör eller en annan teknisk partner.
I den tekniska API-dokumentationen (endast tillgänglig på engelska) finns mer information om hur anropen ska göras, vilka uppgifter som kan hämtas och hur svaren från API:t är uppbyggda.