Skip to end of metadata
Go to start of metadata

This page briefly documents the interfaces currently available at digi.kansalliskirjasto.fi .


Access

Digi interfaces are available for the material, which is openly available from the network. I.e. for newspapers and journals until year 1920. 

Interfaces can be used according to the terms of use of Digi.nationallibrary.fi  , terms are available in Finnish.


OpenURL

OpenURL links you to the page image based on the date information on the URL parameters. The parameters, which are available can be seen from example below:

http://digi.kansalliskirjasto.fi/openurl/query.html?genre=journal&date=1888-01-03&issn=0355-6913&spage=2

  • genre ( journal, no need to change)
  • date (YYYY-MM-DD)
  • ISSN (the identifier of the newspaper or journal)
  • spage  (page number)


The above url returns the page image of Aamulehti 3.1.1888 page 2.

Applicability

  • Use OpenURL if you want permanent reference to the newspaper, without using the binding id.


OAI-PMH

Basic information about the service


Which formats offered: (basically dublin core)


Return the first 100 records, at the end is the resumption token to get next batch

set is either newspaper (sanomalehti) or journal (aikakauslehti). The resumption token by which you can continue the first search is given at the end of the first batch.


Returns different material types:


Returns just identifiers and datestamp:


Return 1 specific record (the identifier is created with help of binding id):


Filter records by date


Applicability

  • Use OAI-PMH if you want the basic binding level metadata. The querying of all records will take some time as batch size via OAI-PMH is limited.


OAI-PMH for Books (new!)

The books operate in the same way as the newspaper and journal materials. In the books , the 'set' is the collection of books, you can find the collection id either from the collection page or by observing the ListSet verb results.

Getting all collections of books

Getting the 'Geography and Travel' collection:

Getting a subcollection (subcollections are separated via colon ((smile) , :

Getting a particular record:

(A quick way is just to replace the binding id of a desired binding to the example above).

JSON

Available for the newspaper and journal title information (core metadata), check out the documentation at:

https://digi.kansalliskirjasto.fi/api/documentation


Sub components of individual binding available

The different sub components of post-processing can be accessed via https://digi.kansalliskirjasto.fi , where <bindingid> is the unique local id of a particular issue number.

https://digi.kansalliskirjasto.fi/sanomalehti/binding/bindingid/image/1   the access page image (.jpg)

https://digi.kansalliskirjasto.fi/sanomalehti/binding/bindingid/thumbnail/1  the thumbnail of the page (.jpg)

https://digi.kansalliskirjasto.fi/sanomalehti/binding/bindingid/pdf   the whole binding as pdf

https://digi.kansalliskirjasto.fi/sanomalehti/binding/bindingid/page-1.txt  the page text as it is.

https://digi.kansalliskirjasto.fi/sanomalehti/binding/bindingid/page-1.xml  returns the ALTO XML,which contains also the layout information.

https://digi.kansalliskirjasto.fi/sanomalehti/binding/bindingid/image/100 sample of an error page, if binding doesn't have that many pages



References



For all questions or comments, please use the Feedback-functionality of http://digi.nationallibrary.fi  .


Tallenna

Tallenna

Tallenna

Tallenna

TallennaTallenna

Tallenna

Tallenna

Tallenna

TallennaTallenna

  • No labels