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 https://bokbasen.jira.com/wiki/spaces/api/pages/48955432 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 https://bokbasen.jira.com/wiki/spaces/api/pages/48955430. 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 https://bokbasen.jira.com/wiki/spaces/api/pages/2994962433.

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

Link

See Pagination

Response
body

XML (Onix)

Returns

200

OK

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

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

Response
body

XML (Onix)

Returns

200

OK