API:er
Låt systemen snacka med varandra
För att digitaliseringen ska bli på riktigt måste informationen kunna flöda fritt. Därför erbjuder vår plattform flera schyssta API:er som gör det enkelt att både hämta ut och peta in data där den behövs. Oavsett om ni vill koppla ihop oss med era egna datalager eller befintliga verksamhetssystem, ser vi till att ni kan flytta informationen utan onödigt krångel.
API:er för olika ändamål
1. API:er för utläsning av information
Dessa API:er används av externa system för att hämta data från plattformen. De flesta av dessa är REST-baserade och kräver normalt åtkomst via VPN-tunnel.
-
API för ärendelistor, ärenden och händelser
Används för att hämta listor på ärenden, enskilda ärenden i XML- eller PDF-format, samt för att följa händelseförlopp (events) i ett ärende.
-
Statistik-API
Hämtar anonymiserad statistik om användningen av e-tjänster (t.ex. ålder, kön, påbörjade/avbrutna steg). Detta API kräver som undantag inte VPN-anslutning.
-
API för generell information om e-tjänster
Används för att hämta listor på publicerade e-tjänster, kategorier och för att söka efter tjänster. Det är ofta publikt och kräver ingen autentisering.
-
API för meddelanden och interna noteringar
Hämtar konversationer mellan handläggare och sökande, samt handläggarens interna anteckningar och tillhörande bilagor.
-
API för bokningsfunktionen
Gör det möjligt att hämta information om kalendrar, lediga bokningstillfällen och befintliga bokningar. Det kan även användas för att visa bokningar i externa system som Outlook.
-
API för köer och köplatser
Hämtar information om tillgängliga köer och aktiva eller arkiverade köplatser.
-
API för användarundersökning
Hämtar resultat och kommentarer från de enkäter som medborgare fyller i efter att ha skickat in ett ärende.
-
API för aktivitetsgrupper
Används specifikt för att hämta ut PDF-kvittenser för avklarade aktivitetsrundor i ärenden som använder aktivitetsgrupper.
-
API för driftmeddelanden
Tillåter externa system att skapa, uppdatera eller ta bort driftmeddelanden som visas i plattformen.
-
API för färgmarkeringar
Används för att läsa av eller sätta färgmarkeringar på ärenden för att underlätta sortering.
-
API för gallrade ärenden
Ger information om vilka ärenden som har tagits bort från plattformen.
2. API för återkoppling
Vårt API för återkoppling (Integration Callback API) låter externa system skriva data tillbaka till plattformen. Det används ofta när handläggningen sker i ett annat verksamhetssystem. Funktioner inkluderar:
- Byte av status på ärenden
- Skicka meddelanden till sökande
- Lägga till händelser i historiken
- Tilldela handläggare
- Sätta attribut på ärenden.
3. API för inläsning till ärenden
Dessa "API-källor" som vi kallar dem kan används under tiden en användare fyller i en e-tjänst för att hämta data "just-in-time" från externa källor:
-
Förifyllnad
Hämta uppgifter till textfält eller hämta listor till rullistor/radioknappar (t.ex. en lista på skolor). -
Kartgeometrier
Lägga ut specifika områden eller symboler i en kartfråga baserat på extern data. -
Val av barn
Hämta utökad information om barn (utöver data som hämtas från Skatteverkets Navet). -
Viktning
Dynamiskt hämta värden som påverkar e-tjänstens logik och vilka följdfrågor som visas.
4. System- och användar-API:er
För att hantera användare och vissa systematiska delar i plattformen finns dessa API:er:
-
API för interna användare
Används för att hämta information om personalkonton, exempelvis baserat på personnummer eller användarnamn.
-
API för grupper
Hanterar användargrupper; man kan skapa grupper, ta bort dem eller hantera medlemskap.
-
API för användarimport
Gör det möjligt för organisationen att skicka XML-filer för att automatiskt skapa och uppdatera personalkonton i plattformen (provisionering).
-
API för reservationer
Hanterar tillfälliga reservationer av objekt, vilket i nuläget främst används i koppling till kartfrågor.
5. E-tjänst-API
Detta API är inte standard utan måste beställas separat. Det används för att administrera handläggarbehörigheter på e-tjänstenivå (inte enskilda ärenden) samt för att hämta ändringsloggar för själva e-tjänstbygget.
Nyfiken att veta mer?
Har du börjat fundera på hur detta skulle kunna hjälpa dig i din vardag? Hör av dig så snackar vi mer!
Mattias Berggren
Affärsansvarig