Lyssna

Så fungerar API-nycklar

Du behöver API-nycklar för att kunna använda Skatteverkets så kallade partner-API:er. Med hjälp av nycklarna kan vi sedan identifiera din programvara vilket behövs när du hämtar en access token från vår auktorisationsserver. Du får oftast två uppsättningar nycklar.

Vad är egentligen API-nycklar?

API-nycklarna, eller client ID och client secret som de ofta kallas, fungerar som en unik identifikation och ett lösenord för just din programvara. Du får dem oftast i två uppsättningar och du använder dem i olika delar av auteniseringsflödet:

OAuth Client ID och Client Secret
Nycklarna används i den första delen av auteniseringsflödet, mot auktorisationsservern.

APIgw Client ID och Client Secret
Nycklarna används i ett senare skede av auteniseringsflödet då du ska anropa API:et via Skatteverkets API-gateway.

API-nycklarna är en del av en textfil som Skatteverket av säkerhetsskäl skickar ut i två delar via två separata kommunikationskanaler. Textfilen innehåller bland annat två uppsättningar API-nycklar och information om scope. Scopet talar om vilket eller vilka API:er dina nycklar är kopplade till.

Begär tillgång till API:et först och få nycklar sedan

Du får API-nycklar genom att begära tillgång till ett API. Om det är en komplett testtjänst du begär tillgång till får du oftast API-nycklarna inom några dagar, men för API:er i produktionsmiljö behöver du ingå avtal med Skatteverket först. Det tar oftast några veckor.

Återanvända API-nycklar eller få nya

Det går oftast bra att använda samma API-nycklar för flera API:er. När du begär tillgång till ett nytt API meddelar du oss att du redan använder ett annat API och därför vill återanvända befintliga nycklar. Använd fältet "vill du återanvända API-nycklar".

Det finns dock två situationer då du behöver helt nya API-nycklar.

Du använder en testmiljö och vill gå över till att använda produktionsmiljön. Det går nämligen inte att använda API-nycklar avsedda för testmiljöer i produktionsmiljö (och vice versa).
Du använder säkerhetslösningen Client Credentials Grant tillsammans med ett organisationslegitimation. Just det här flödet kräver att du kopplar ihop ditt OAuth Client ID med organisationslegitimationen du vill använda. När kopplingen är gjord ersätter organisationslegitimationen din Oauth Client Secret, som alltså inte kan användas.

När du använder en testmiljö och vill gå över till att använda produktionsmiljön måste du alltid skaffa nya nycklar. Det går nämligen inte att använda API-nycklar avsedda för testmiljöer i produktionsmiljö (och vice versa).

Lär dig mer

Kontakta oss

Kontakt och öppettider

Hitta snabbt

Webbseminarier för företagare

Vill du lära dig mer om skatter och företagande? Ta då chansen och möt oss online på våra direktsända webbseminarier. Det är kostnadsfritt och du kan ställa frågor och få svar i en chatt.

Till webbseminarierna

Aktuellt

Sommarjobbare kan jämka för rätt skatt från början
Den som tjänar mindre än 20 431 kronor på ett sommarjobb och inte har andra inko...
Anstånd att lämna inkomstdeklaration till den 19 maj
En del användare har under måndagen haft svårt att logga in på Skatteverkets e-t...
Hinderspröva i tid för kommande bröllop
Den som planerar att gifta sig i sommar gör klokt i att ansöka om hindersprövnin...

Fler nyheter

Till toppen

Om oss