MARC

Bokbasen has several MARC products where Bokbasen metadata is available using our export API. The API is the same for all products, so the only difference is the URL used to access the API.

Product	URL - NORMARC	URL - MARC21
Bokbasen standard MARC product covering Norwegian literature	https://api.boknett.no/metadata/export/marc	https://api.boknett.no/metadata/export/marc21
Bokbasen MARC product bundled with the digital lending platform, gives access to digital products available on the platform.	https://api.boknett.no/metadata/export/marc/loan	https://api.boknett.no/metadata/export/marc21/loan
Bokbasen additional MARC product covering Norwegian, and English titles and movies.	https://api.boknett.no/metadata/export/marc/complete	https://api.boknett.no/metadata/export/marc21/complete

API documentation

The Bokbasen MARC export service works the same way as all other export service (with some simplifications), but returns metadata in the NORMARC format.

URL	URL from above
Method	GET
Request headers	Authorization	Required	The token acquired from the Authentication Service (legacy). Formated "Boknett TGT-...."
	Date	Required	The timestamp the request was made. Must comply with RFC 1123 date formats. Example: Tue, 10 Jun 2014 16:23:42 GMT
Query parameters	next	Required*	All data elements modified after this “cursor”. The cursor is in a not human readable format.
	after	Required*	All data elements modified after this timestamp. The timestamp is on the format yyyyMMddHHmmss.
Response headers	Next	See Pagination
	Link	See Pagination
Response body	NORMARC
Returns	200	OK

* One of the parameters “next” and “after” is required.

Example usage

curl -H "Authorization: Boknett TGT-13-amdKXpdVvSkEZ6" -H "Date: Tue, 01 Apr 2014 13:15:00 GMT" https://api.boknett.no/metadata/export/marc/?after=20140109130000

Returns a report with marc data for elements modified after 20140109130000

curl -H "Authorization: Boknett TGT-13-amdKXpdVvSkEZ6" -H "Date: Tue, 01 Apr 2014 13:15:00 GMT" https://api.boknett.no/metadata/export/marc/?next=28sHyi34ddFFGe23=

Returns a report with marc data modified after the timestamp logically represented by 28sHyi34ddFFGe23=

Response

The response is of type text/plain. There is no metadata except for the NORMARC data itself. An example payload of the response for a single marc post is shown below.

Marc data for a single post

*000     nam               
*001221506
*008930701s1993           jr         1 nob 9
*019  $amu $bl
*020  $a82-03-24006-2 $bib $c98.00
*020  $a978-82-03-24006-5 $bib $c98.00
*025  $a9788203240065
*040  $aBokbasen AS
*10010$aLorentzen, Karin
*24510$aZorbas sønn
*250  $a1. utg.
*260  $aOslo $bAschehoug $c1993
*300  $a128 s.
*440  $aGod bok
*650  $aHester
*650  $aKjærlighet
*650  $aUngdom