EntryScape API gör EntryScape Catalog till en byggsten. Med ett REST-gränssnitt kan era system, skript och AI-assistenter läsa, söka, skapa, uppdatera och validera DCAT-AP-metadata och ladda upp datafiler, utan att någon behöver öppna webbgränssnittet.
Ni litar redan på EntryScape Catalog för att beskriva och publicera era data. Med API:et kan ni automatisera det arbetet. Skicka datamängder direkt från källsystemen, håll distributionerna aktuella enligt ett schema, kontrollera DCAT-AP innan något publiceras och bygg egna portaler och appar ovanpå katalogen. Med färdiga SDK:er för Python, JavaScript, TypeScript och C# och en MCP-server för AI-assistenter kommer ert team igång på timmar i stället för veckor.
Problemet vi löser
Manuellt katalogarbete skalar inte. Organisationer som publicerar öppna eller delade data möter samma hinder:
- Metadata finns någon annanstans. Datamängder beskrivs i GIS-verktyg, datalager och register och skrivs sedan in en gång till i katalogen.
- Filer blir inaktuella. Någon måste komma ihåg att ladda upp månadens CSV, så publicerade data ligger efter verkligheten.
- DCAT-AP kontrolleras för sent. Felen upptäcks efter publiceringen, när en portal som dataportal.se avvisar eller döljer posten.
- Katalogen blir en silo. Utvecklare som vill visa katalogens innehåll på egna webbplatser eller i appar saknar en tydlig och dokumenterad väg in.
- AI-assistenter ser den inte. Allt fler arbetar med AI-verktyg som inte har tillgång till organisationens förteckning över data.
Det här kan API:et
API:et täcker hela livscykeln för kataloger, datamängder, distributioner och datatjänster. Allt finns beskrivet i dokumentationen för EntryScape API (på engelska).
- Öppen läsåtkomst. Lista publika kataloger, datamängder och distributioner utan inloggning. Vem som helst kan bygga vidare på publicerade data direkt.
- Sök. Fritextsök som kan filtreras och som visar hur träffarna fördelar sig, till exempel per tema, utgivare eller format. Så hittas rätt datamängd även i stora kataloger.
- Fullständig RDF-metadata. JSON-LD som standard, Turtle och andra RDF-format på begäran. Länkade data enligt standard, utan inlåsning.
- Skapa, uppdatera och ta bort. Skriv DCAT-AP-entiteter som JSON-LD med anrop som autentiseras med token, så att metadata flödar direkt från källsystemen.
- Validering mot DCAT-AP. Kontrollera en entitet mot profilen innan den skrivs och få en detaljerad felrapport. Problemen fångas innan de når en portal.
- Filhantering. Ladda upp och ersätt distributionsfiler som bakgrundsjobb. Svaret är 202 med ett jobb-id, och jobbstatusen visar läget och adressen till den nya filen.
- Automatiska API:er hålls aktuella. Har en distribution ett automatiskt genererat API uppdateras det när en ny CSV-fil laddas upp.
- SDK:er. Genererade för Python, JavaScript, TypeScript och C#, med exempel som går att köra.
- MCP-server och tillägg för Claude Code. Kopplar AI-assistenter till katalogen, så att ni kan fråga, söka och kurera på vanlig svenska.
- Hos oss eller hos er. Driftas på api.entryscape.com eller på er egen domän och passar både molnkunder och egna installationer.
API:et ersätter Taskrunner, som fasas ut. Uppladdningar svarar 202 med ett jobb-id, och fel upptäcks tidigare: 413 för för stora filer och 422 för fel sorts adress, innan jobbet köas. Läs guiden för att byta från Taskrunner (på engelska).
Så kan ni använda det
EntryScape Catalog är fortfarande platsen där data kureras och styrs. API:et kopplar katalogen till allt annat.
Data som uppdateras av sig själv
En kommun publicerar luftkvalitet, budget eller trafikdata varje månad. Ett schemalagt Python-skript ersätter distributionens fil via API:et och följer jobbet tills det är klart. Datamängden på portalen är alltid aktuell, utan manuell uppladdning.
Metadata direkt från källsystemen
En myndighets GIS-plattform eller datalager känner redan till sina datamängder. En integration skapar och uppdaterar DCAT-AP-datamängder i katalogen, så att metadata skrivs in en gång, vid källan. Från katalogen skördas de sedan vidare till nationella portaler som dataportal.se, precis som i dag.
Kvalitetskontroll före publicering
Varje ändring går först genom valideringen. Felen kommer tillbaka som en detaljerad rapport, så att en CI-pipeline eller en dataförvaltare rättar dem innan posten publiceras. Det ger färre avvisade poster och bättre metadatakvalitet.
Egna portaler och appar
En region vill ha en egen datasajt för sina invånare. Utvecklarna använder SDK:n för JavaScript och TypeScript och de öppna läsanropen för att lista, söka och filtrera datamängder från katalogen, medan kureringen sker i EntryScape.
Ett data-API som följer med filen
En avdelning har ett automatiskt API kopplat till sin distribution. När en ny CSV-fil laddas upp via API:et uppdateras även data-API:t, så att utvecklare och appbyggare alltid frågar mot de senaste raderna i stället för att ladda ner filer.
Katalogarbete med AI
Med MCP-servern kan medarbetare fråga en AI-assistent ”Vilka av våra datamängder saknar licens?” eller ”Skriv ett utkast till beskrivning av den nya datamängden”. Assistenten söker och läser i katalogen och kan, med rätt behörighet, föreslå eller skriva ändringar.
Stora flyttar och städning
En organisation som går från kalkylark eller en äldre katalog importerar många datamängder med ett skript och använder sedan sök och validering för att hitta och täppa till luckorna.
Integration i .NET
Organisationer som använder Microsofts plattform kopplar ärendehantering eller affärssystem med SDK:n för C# och publicerar referensdata och register till katalogen som en del av sina befintliga arbetsflöden.
Vad det ger
- Utvecklare får dokumenterat REST, JSON-LD, SDK:er på fyra språk, exempel som går att köra och tydliga felkoder. Integrationen tar en eftermiddag.
- Dataägare och dataförvaltare får automatisk uppdatering, validering före publicering, verktyg för stora mängder och hjälp av AI. Mer tid till datakvalitet och mindre till inmatning.
- IT-chefer och ledning får mindre manuellt arbete, bättre följsamhet mot DCAT-AP, återanvändning av befintliga system och ingen inlåsning.
- Dataanvändare och appbyggare får öppen läsåtkomst, sök och data-API:er som hålls aktuella. Aktuella data att lita på och bygga vidare på.
Varför EntryScape
Beprövat i nationell skala. EntryScape är plattformen bakom Sveriges nationella dataportal, dataportal.se, och ngs.ehalsomyndigheten.se. API:et öppnar samma plattform för era egna system.
Byggt på öppna standarder. DCAT-AP, RDF och länkade data i grunden, med MetaSolutions erfarenhet av semantisk informationsmodellering.
Kom igång
- Använder ni redan EntryScape Catalog? Prova de öppna läsanropen mot er egen katalog i dag och boka sedan en genomgång med oss för att automatisera er första datamängd.
- Använder ni Taskrunner? Byt nu och få SDK:er och fel som upptäcks innan jobbet körs.
- Ny hos oss? Låt oss visa en demo: från uppladdad CSV till publicerad och validerad datamängd med ett fungerande API på några minuter.
Läs mer i dokumentationen för EntryScape API (på engelska) och dokumentationen för EntryScape Catalog, eller kontakta oss.
