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:
- 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
- http://digi.kansalliskirjasto.fi/interfaces/OAI-PMH?verb=ListRecords&metadataPrefix=oai_dc&set=sanomalehti
- http://digi.kansalliskirjasto.fi/interfaces/OAI-PMH?verb=ListRecords&resumptionToken=s9bbfLpHRi+100
- http://digi.kansalliskirjasto.fi/interfaces/OAI-PMH?verb=ListRecords&metadataPrefix=oai_dc&set=aikakauslehti
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 (
, :
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
- OAI-PMH Specification at OpenArchives.org http://www.openarchives.org/OAI/openarchivesprotocol.html .
For all questions or comments, please use the Feedback-functionality of http://digi.nationallibrary.fi .