Versions Compared

Version Old Version 9 New Version Current
Changes made by

Svein Are Grønsund

Fride Fosseng

Saved on

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

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.

...

Bokbasen

...

MARC

...

export

...

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 MARC21 format.

URL

URL from above

https://api.bokbasen.io/metadata/export/marc/v1

Method

GET

Request
headers

Authorization

Required

The

Access-token

acquired

from

the

Authentication Service

(legacy).

Formated "Boknett TGT-...."

DateRequiredThe timestamp the request was made. Must comply with RFC 1123 date formats. Example: Tue, 10 Jun 2014 16:23:42 GMT

Audience: https://api.bokbasen.io/metadata/

The service has two scopes: export:marc and export:marc_nb. export:marc_nb returns a subset of the information contained in export:marc. A client can only have one of the two scopes at any given time

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.

pagesize

Default (and max) 1000

Response
headers


Next

See Pagination

Link

See Pagination

Response
body

NORMARC

MARC21 (application/xml)

Returns

200

OK

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

...

Code Block
languagebash
curl \
  -H "Authorization: BoknettBearer TGTYOUR-13TOKEN-amdKXpdVvSkEZ6HERE" -H\
"Date: Tue, 01 Apr 2014 13:15:00 GMT" https://api.boknettbokbasen.noio/metadata/export/marc/v1?after=20140109130000

Returns a report with marc data for elements modified after 20140109130000“20140109130000”

 

Code Block
languagebash
curl \
  -H "Authorization: BoknettBearer TGTYOUR-13TOKEN-amdKXpdVvSkEZ6HERE" -H "Date: Tue, 01 Apr 2014 13:15:00 GMT" \ 
  https://api.boknettbokbasen.noio/metadata/export/marc/v1?next=28sHyi34ddFFGe23MThmMTNjNWZkZGYjIzM4MzM2NjY1NjEzNDYyMzkyZDM0MzEzMjM5MmQzNDM4MzYzNTJkNjIzNzYzMzMyZDYyNjEzNDY2NjUzNTMyMzE2MjY1MzEzOTNhMzkzNzM4MzAzODM2MzQzNDMyMzYzMDMwMzA=

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

Response

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

...

Marc data for a single post

...

Code Block
languagebash
<?xml version="1.0" encoding="UTF-8" standalone="yes"?>
<record xmlns="http://www.loc.gov/MARC21/slim" type="Bibliographic">
	<leader>00000nam#a2200000#c#4500</leader>
	<controlfield tag="008">121106t2013||||no#####e#||||||||#1|nob|d</controlfield>
	<datafield tag="019" ind1=" " ind2=" ">
		<subfield code="b">l</subfield>
	</datafield>
	<datafield tag="020" ind1=" " ind2=" ">
		<subfield code="a">9788249511310</subfield>
		<subfield code="q">heftet</subfield>
	</datafield>
	<datafield tag="040" ind1=" " ind2=" ">
		<subfield code="a">NO-OsBAS</subfield>
		<subfield code="b">nob</subfield>
		<subfield code="e">rda</subfield>
	</datafield>
	<datafield tag="082" ind1="0" ind2="4">
		<subfield code="a">839.81374</subfield>
		<subfield code="q">NO-OsBAS</subfield>
		<subfield code="e">23/nor/20240228</subfield>
	</datafield>
	<datafield tag="100" ind1="1" ind2=" ">
		<subfield code="a">Helle, Helle</subfield>
		<subfield code="d">1965-</subfield>
		<subfield code="0">(NO-TrBIB)99043030</subfield>
		<subfield code="4">aut</subfield>
	</datafield>
	<datafield tag="240" ind1="1" ind2="0">
		<subfield code="a">Forestillingen om et ukompliceret liv med en mand</subfield>
		<subfield code="l">Norsk</subfield>
	</datafield>
	<datafield tag="245" ind1="1" ind2="0">
		<subfield code="a">Forestillingen om et ukomplisert liv med en mann :</subfield>
		<subfield code="b">roman</subfield>
		<subfield code="c">Helle Helle ; oversatt av Trude Marstein</subfield>
	</datafield>
	<datafield tag="264" ind1=" " ind2="1">
		<subfield code="a">Oslo</subfield>
		<subfield code="b">Oktober</subfield>
		<subfield code="c">2013</subfield>
	</datafield>
	<datafield tag="300" ind1=" " ind2=" ">
		<subfield code="a">173 sider</subfield>
		<subfield code="c">21 cm</subfield>
	</datafield>
	<datafield tag="336" ind1=" " ind2=" ">
		<subfield code="a">tekst</subfield>
		<subfield code="0">http://rdaregistry.info/termList/RDAContentType/1020</subfield>
		<subfield code="2">rdaco</subfield>
	</datafield>
	<datafield tag="337" ind1=" " ind2=" ">
		<subfield code="a">uformidlet</subfield>
		<subfield code="0">http://rdaregistry.info/termList/RDAMediaType/1007</subfield>
		<subfield code="2">rdamt</subfield>
	</datafield>
	<datafield tag="338" ind1=" " ind2=" ">
		<subfield code="a">bind</subfield>
		<subfield code="0">http://rdaregistry.info/termList/RDACarrierType/1049</subfield>
		<subfield code="2">rdact</subfield>
	</datafield>
	<datafield tag="520" ind1=" " ind2=" ">
		<subfield code="a">Susanne bor sammen med Kim, som vil være forfatter og derfor sitter hjemme og jobber. Susannes venninne Ester går fra kjæresten sin i høygravid tilstand og ber om hjelp. Da Susanne og Kim lar henne flytte inn i den lille leiligheten deres blir alt snudd på hodet, og den besværlige graviditeten irriterer, samtidig som man jo må oppføre seg ordentlig. Situasjonen skaper sjalusi og irritasjon, og skaker ved forholdet mellom Susanne og Kim. Helle Helle skildrer dette merkelige forløpet med en voldsom realisme og en ny klukkende humor.</subfield>
	</datafield>
	<datafield tag="650" ind1="1" ind2="7">
		<subfield code="a">Ekteskap og parforhold</subfield>
		<subfield code="2">bokbas</subfield>
		<subfield code="9">nob</subfield>
	</datafield>
	<datafield tag="651" ind1=" " ind2="7">
		<subfield code="a">København</subfield>
		<subfield code="2">bokbas</subfield>
		<subfield code="9">nob</subfield>
	</datafield>
	<datafield tag="655" ind1=" " ind2="7">
		<subfield code="a">Romaner</subfield>
		<subfield code="2">bokbas</subfield>
	</datafield>
	<datafield tag="700" ind1="1" ind2=" ">
		<subfield code="a">Marstein, Trude</subfield>
		<subfield code="d">1973-</subfield>
		<subfield code="0">(NO-TrBIB)99000603</subfield>
		<subfield code="4">trl</subfield>
	</datafield>
</record>