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. 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.
*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