OAI PMH
Riksarkivet publicerar data till Archives Portal Europe via OAI-PMH. OAI-PMH är ett standardprotokoll för metadata harvesting, dvs hämtning av metadata från olika källor. OAI-PMH använder HTTP för request och response, där response har XML-format (content-type: text/xml).
OAI-PMH är tänkt för skördning, dvs masshämtning av data för bearbetning och lagring i egna system. Det finns inga sök- eller sorteringsfunktioner. Om man känner till identifierare för en enskild post kan man hämta dess fullständiga data med metoden GetRecord (se nedan).
https://oai-pmh.riksarkivet.se/OAI
Riksarkivets OAI-PMH Repository stöder följande OAI-PMH-metoder "verb":
https://oai-pmh.riksarkivet.se/OAI?verb=Identify
Svaret innehåller grundläggande information om tjänsten.
https://oai-pmh.riksarkivet.se/OAI?verb=ListMetadataFormats
Svaret listar de XML-format för metadata som tjänsten stöder.
OBS! tjänsten stöder inte query-parametern identifier={identifier} för att lista vilka metadataformat som är tillgängliga för en specifik post.
- Encoded Archival Description, anpassad för Archives Portal Europe (apeEAD), XML-schemat för apeEAD är ett subset av XML-schemat för EAD2002
- Encoded Archival Description, anpassad för Riksarkivet (RA-EAD), ett annat subset av XML-schemat för EAD2002
https://oai-pmh.riksarkivet.se/OAI?verb=ListAllAuth
Svaret listar de dataset som finns tillgängliga för ListIdentifier. OBS! metoden ListAllAuth ingår inte i OAI-PMH-standarden, resultatet refererar till OAI-PMH:s XML-schema men validerar inte mot det.
Tjänsten stöder inte metoden ListSets.
https://oai-pmh.riksarkivet.se/OAI/{dataset}?verb=ListIdentifiers
t.ex.
https://oai-pmh.riksarkivet.se/OAI/SE_ULA?verb=ListIdentifiers
Svaret listar alla identifierare för poster i datasetet. Tjänsten stöder på posternas tidsstämplar med query-parametrarna from och until.
Notera att datasetets id måste anges i adressen (/SE_ULA i exemplet).
Tjänsten stöder inte metoden ListRecords. För att hämta kompletta data om ett dataset, använd ListIdentifiers och ett anrop till GetRecord för varje identifierare.
där metadata-prefix skall vara en av
| prefix | metadataformat |
|---|---|
| oai_ape_ead | EAD XML, anpassning för APE |
| oai_ra_ead | EAD XML, anpassning för Riksarkivet |
identifier är Riksarkivets referenskod, t.ex.
- SE/ULA/10012 - Alunda kyrkoarkiv (arkiv)
- SE/ULA/10012/A 1 - Husförhörslängder (serie)
- SE/ULA/10012/A 1/1 - 1752 - 1764 (volym)
Observera att om identifieraren innehåller mellanslag " " så ska dessa URL-kodas med "+" (inte "%20").
Exempel:
Svaret innehåller fullständiga data för en post i angivet dataformat (apeEAD eller RA-EAD). EAD (Encoded Archival Description) är ett standardiserat XML-format för överföring av arkivinformation. Riksarkivets OAI-PMH-tjänst kan som beskrivs ovan leverera data i två olika EAD-baserade format.
Beskrivning av EAD-data för arkivenheter:
Riksarkivet levererar arkiv-metadata till Archives Portal Europe med OAI-PMH-tjänsten. Dessa metadata är tillgängliga för sökning, tillsammans med metadata från ett stort antal europeiska arkivinstitutioner. Alla data i APE är tillgängliga under CC0-licens. APE tillhandahåller också ett REST-API. Observera att detta API kräver en API-nyckel.
Riksarkivet använder OAI-PMH-tjänsten för att generera en nedladdningsbar datamängd med publikt tillgängliga arkivmetadata. Avsikten är att uppdatera detta datauttag årligen.
