ONIX

This endpoint is used for loading metadata from Bokbasen, it is specifically design to give you a continuous feed of all changes that are available. See Export Service for details on paging mechanism.

New Authentication & URLs introduced Q4 2023

URL	`https://api.bokbasen.io/metadata/export/onix/v1` `https://api.boknett.no/metadata/export/onix` The token acquired from the Authentication Service (legacy). Formated `Boknett TGT-....` Header: `Date` (required). The timestamp the request was made. Must comply with RFC 1123 date formats.
Method	`GET`
Request headers	`Authorization`	Required	Access-token from Authentication Service. Audience: `https://api.bokbasen.io/metadata/`
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.
	`subscription`	Required	Specifies the scope of the report. Possible values are basic, extended or school. Represents the subscriptions Basic, Extended and School.
	`notificationType`	Optional	The type of notification, which can be updated (new and updated elements) and deleted. Empty or missing parameter will result in both updated and deleted elements.
	`pagesize`	Optional	See Pagination
Response headers	`Next`	See Pagination
Response headers	`Link`	See Pagination
Response body	XML (Onix)
Returns	200	OK
Returns	413	Try with a smaller `pagesize`

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

Beware of the 413-error - try again with a smaller pagesize

Get ONIX for single book

This is a convenience API provided so that it is possible to lookup the ONIX for a single ISBN.

This API endpoint is just in use for debugging and testing purposes, no production application should be based on using this endpoint. Misusage of the endpoint might lead to it being closed down. Use the endpoint above for your production update processes.

URL	`https://api.bokbasen.io/metadata/export/onix/v1/{isbn}` `https://api.boknett.no/metadata/export/onix/{isbn}` The token acquired from the Authentication Service. Formatted `Boknett TGT-....` Required header: `Date` The timestamp the request was made. Must comply with RFC 1123 date formats.
Method	`GET`
Request headers	`Authorization`	Required	The token acquired from the Authentication Service Audience: `https://api.bokbasen.io/metadata/`
Response body	XML (Onix)
Returns	200	OK