Riksarkivets publika API:er
Senast uppdaterad: 2023-08-21
Riksarkivet som dataplattform omfattar ett antal publikt tillgängliga API:er. Dessa API:er ger lästillgång till öppna, allmänt tillgängliga data.
Skördning av metadata via OAI-PMH
Open Archives Initiative – Protocol for Metadata Harvesting är ett protokoll för metadataskördning, det vill säga hämtning av metadata för Riksarkivets arkivhandlingar.
Dokumentation för skördning av metadata
Visning av digitala arkivhandlingar via IIIF
International Image Interoperability Framework är ett API för hantering av framförallt bilder men även rörlig bild (video) och ljud. Riksarkivet stöder anrop för presentation av bilder, med utsnitt, skalning med mera samt anrop för bläddring i en samling mediaresurser.
Dokumentation för visning av digitala arkivhandlingar
Sök-API (beta-version)
Riksarkivets sök-API är ett REST-API som ger externa system tillgång till sökning motsvarande söktjänstens samsök och exponerar publika information som länkade data (Resource Description Framework, RDF ). För närvarande (sommaren 2023) är sök-API:et att betrakta som en beta-version.
Länkade data (beta-version)
Riksarkivet använder Resource Description Framework (RDF) som representation för enskilda arkivposter (arkiv, serier, volymer, auktoriteter, med mera) med serialisering i RDF/XML och JSON-LD . Mappningen av data till RDF är ett pågående arbete som idag inte är komplett.
Dokumentation för våra länkade data
Tillgängliga arkiv
OAI-PMH
Det går att skörda metadata för alla godkända arkiv i Riksarkivets bestånd, dessa är även tillgängliga i söktjänsten. Det kan finnas enstaka serier, volymer med mera i godkända arkiv som inte är godkända. Metadata för dessa ingår inte vid skördning. Andra arkivinstitutioners arkiv i NAD är för närvarande inte tillgängliga för OAI-PMH-skördning.
IIIF
Enbart bilder som har explicit rättighetsmärkning och som visar material som är 110 år eller äldre är tillgängliga via IIIF. Bilder som hör till följande datamängder i söktjänstens specialsök är tillgängliga oavsett om det finns en explicit rättighetsmärkning:
- Svenskt diplomatariums huvudkartotek (SDHK)
- Folkräkningar, äldre än 110 år
Färdplan
Under 2023 är vår plan att påbörja utvecklingen av ett API för att söka i NAD och Riksarkivets övriga större register och databaser. Vår avsikt är att API:et ska motsvara sök-, facetterings- och sorteringsmöjligheterna samt informationsinnehållet i vår Samsöktjänst. Vi kommer också att påbörja utvecklingsarbetet med att göra poster i NAD tillgängliga som länkade data
Tanken är att göra dessa nya funktionaliteter tillgängliga först i enkla versioner, med första versioner kanske enbart tillgängliga för testanvändning, för att därefter stegvis uppdatera dem. Inget datum är ännu satt för när de första versionerna kommer att bli tillgängliga.