Sök i arkiven
Genvägar MENY

Frågor och svar


Var hittar jag dokumentation om hur Riksarkivets publika API:er används rent tekniskt?

Dokumentationen hittar du på Riksarkivets API-dokumentation på GitHub .

Får jag använda API:erna för kommersiella syften, till exempel för att utveckla en app eller webbsida som jag tar betalt för?

Ja, API:erna är helt publika och öppna och kan användas även för kommersiella syften.

Vissa bilder som jag kan se i Söktjänsten går inte att hämta via IIIF API, varför är det så?

För att bilder ska kunna tillgängliggöras i IIIF API krävs att det skannade arkivmaterialet är fritt från restriktioner gällande personuppgifter och sekretess, att bild- och arkivmaterialet är rättighetsmärkt med en öppen licens, t.ex. Public Domain Mark (PDM), CC-BY eller CC0 samt att det skannade arkivmaterialets datering är äldre än 110 år.

Om du försöker anropa en bild som inte uppfyller dessa krav via IIIF API kommer du få meddelandet 403 Forbidden, trots att du kanske kan se bilden i Söktjänstens bildvisning.

Arbete pågår med att märka skannade bilder med rätt licenser, och målet är att så mycket bildmaterial som möjligt ska kunna nås via API.

Läs mer i avsnittet om rättigheter i IIIF-dokumentationen på GitHub .

Jag har utvecklat en webbtjänst som använder Riksarkivets publika API:er, måste jag ange att det är Riksarkivets API:er som används i webbtjänsten?

Nej, det behöver du inte. Men vi uppskattar om du gör det, till exempel genom att skriva följande någonstans i tjänsten:

Tjänsten använder data och bilder från Riksarkivets öppna API:er.

Gärna med en länk till Riksarkivet .

Du får också gärna höra av dig och berätta att du använder våra API:er. Det hjälper oss att visa hur Riksarkivets öppna data kommer till användning.

Jag har utvecklat en webbsida som visar bilder av arkivhandlingar hämtade via Riksarkivets API:er. Vilken information bör jag visa i anslutning till varje bild?

I anslutning till bilden bör du ange bildens licens och källhänvisa till rätt arkivhandling. Båda dessa värden finns i bildens IIIF-manifest under "Rättigheter för digital reproduktion" och "Källhänvisning".

Hur laddar jag ner alla bilder i en skannad volym till min dator?

I Söktjänstens bildvisning är det möjligt att ladda ner en bild i taget. Vill du ladda ner alla bilder i en volym samtidigt kan du använda Riksarkivets IIIF API och ett färdigt skript.

Du hittar skriptet för att ladda ner alla bilder i en volym på GitHub .

Kan jag nå folkräkningar via Riksarkivets publika API:er?

Nej, folkräkningar finns inte i API:et. Du kan ta del av folkräkningar i Söktjänstens specialsök Folkräkningar (Sveriges befolkning).

För att beställa datauttag av folkräkningar, eller andra datamängder som inte finns i API:et, använder du beställningsformuläret övriga beställningar .

Akademiska forskare kan få tillgång till viss folkräkningsdata via den nationella forskningsinfrastrukturen Swedpop .

Behöver jag en API-nyckel eller annan autentisering för att använda API:erna?

Nej. Riksarkivets publika API:er är öppna och kräver ingen API-nyckel, registrering eller inloggning.

Finns det några begränsningar för hur många anrop jag får göra?

Följ gärna dessa riktlinjer när du använder API:erna

  • Gör högst ett anrop per sekund, och gör anropen ett i taget i stället för parallellt.
  • Ange gärna en User-Agent som berättar vem du är, till exempel namnet på din tjänst.
  • Spara gärna det du redan har hämtat. Bilder och data uppdateras ganska sällan. En ny hämtning en gång i veckan eller i månaden räcker långt.
  • Om någon tjänst belastar API:erna så mycket att det påverkar andra användare kan vi behöva begränsa dess åtkomst.