Anslutning och support för våra API:er och öppna data

Varje API lanseras som enkel testtjänst (mockup), komplett testtjänst (sandbox) och driftsatt tjänst. På så sätt kan du som programvaruutvecklare starta din utveckling av nya tjänster redan innan ett API är driftsatt.

Enkel testtjänst (mockup)

Enkel testtjänst är en testmiljö med statiskt hårdkodad data. Den enkla testtjänsten är öppen för alla och tillgänglig för respektive API i Utvecklarportalen.

Komplett testtjänst (sandbox)

Komplett testtjänst är en testmiljö med dynamiska data. Du behöver ansöka om att få tillgång till dem genom att fylla i formulär på Skatteverkets webbplats. Du behöver även godkänna Skatteverkets användarvillkor. När vi har godkänt din förfrågan får du API-nycklar, client_id och client_secret. Du behöver dem för att anropa API:et. Nycklarna skickas via mejl. Testdata och URI till den kompletta testtjänsten finns för respektive API i Utvecklarportalen.

Driftsatt tjänst

Driftsatt tjänst är API:et i produktion. För att få tillgång ska ditt företag uppfylla Skatteverkets krav för API:et och du ska skriva under ett avtal. Du kan ta del av avtal och villkor för respektive API i Utvecklarportalen. Fyll sedan i formuläret ”Begär tillgång till driftsatt tjänst”. När vi har godkänt din förfrågan och avtalen är signerade får du API-nycklar client_id och client_secret. De behöver du för att anropa API:et. Nycklarna skickas via mejl och sms. URI till den driftsatta tjänsten finns för respektive API i Utvecklarportalen.

• Utvecklarportalen Länk till annan webbplats.

Detaljerad teknisk information

I Utvecklarportalen finns all dokumentation om API:et. Där finns en översikt, information om åtkomst, säkerhet och nycklar, användning, tjänstebeskrivning och exempelkod. Där hittar du även villkor och avtal.

• Utvecklarportalen Länk till annan webbplats.

Begär tillgång till kompletta testtjänster

För att begära access till komplett testtjänst (sandbox) för ett API behöver du fylla i och skicka in ett formulär för valt API.

• Begär tillgång till kompletta testtjänster
  

Begär tillgång till driftsatta tjänster

För att få tillgång till ett API i driftsatt tjänst behöver du fylla i och skicka in ett formulär till Skatteverket.

• Begär tillgång till driftsatta tjänster

Vi använder oss av en anslutningsprocess, avtal och tekniska säkerhetslösningar för att säkerställa att personrelaterad och sekretessbelagd information skyddas. För varje API finns det specifika krav som du behöver uppfylla för att få tillgång till API:et. De krav som Skatteverket ställer finns i Utvecklarportalen under respektive API.

• Utvecklarportalen Länk till annan webbplats.

Kontakta oss genom att fylla i ett formuläret "Uppdatera eller avsluta befintligt API". Kontakta oss om API:er om du behöver uppdatera din API-applikation med ny information, såsom nytt redirect_URI eller ny kontaktperson. Du kan även avregistrera tillgången till API:et via formuläret.

Fyll i de sex sista siffrorna i API-nycklarna, alltså ditt client_id och client_secret i formuläret. På så vis identifierar du dig på ett säkert sätt.

När vi har tagit emot ditt ärende gör vi förändringen och meddelar dig via mejl.

• Uppdatera anslutning till ett API
• Avsluta anslutning till API

API:er (Application Programming Interface) är en teknik som gör det möjligt för två program att utbyta data med varandra. De API:er som Skatteverket erbjuder gör det möjligt för andra aktörer, till exempel företag, att kommunicera med våra system och på så vis använda Skatteverkets data i sina egna tjänster. Lär dig mer om API:er här:

• Vad är ett API

En redirect-URI är en adress hos er som används för att ange vart anrop ska dirigeras tillbaka efter en lyckad autentisering. Du skickar med redirect-URI:n i anropet och den jämförs med en av de redirect-URI:er som du anmälde till oss i samband med registrering. På så vis kan vi skydda trafiken från att omdirigeras till andra främmande adresser efter autentiseringen.

Redirect-URI används i OAuth2.0-flödet Authorization Code Grant (ACG) som Skatteverket nyttjar för autentisering.

Formatet för en redirect-URI:
https://domännamn[:port]/[resurs]

Läs mer om ACG:

• Authorization Code Grant (ACG)

Informationen lämnas i ett format som följer en öppen standard, främst csv (comma-separated values) och ett tillhörande API (application programming interface). För informationsmängder där andra format efterfrågats försöker vi tillhandahålla även dessa. Det kan vara till exempel excel eller txt.

Vi publicerar informationen i så maskinläsbar form som möjligt. På sikt vill vi tillgängliggöra informationen som ett API eller som länkad data.

Öppna data är information som finns tillgänglig för vem som helst att använda, återanvända och dela med sig av, så att andra kan utveckla den och skapa nytta för fler. Skatteverkets öppna data är alltid på aggregerad nivå, alltså en sammanställning av många olika data. Det går inte att få ut data på individnivå via våra öppna data.

Läs gärna vidare i artikeln:

• Vad är öppna data?