Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.
Table of Contents
Info

New Authentication & URLs introduced Q2 2024

Object Report

The objects (images and audio files) report contains identifiers and references to the address where the objects can be downloaded. These references will be valid for a limited period of time. The typical use of the object services is as follows:

  1. Authenticate (same for all services)

  2. Request report (list) of updated objects

  3. Parse list of updated objects (obtain URL to download service for each object)

  4. Download actual objects from download service (one or more requests per object) 

Method

URL

https://api.boknettbokbasen.noio/metadata/export/object/v1

Expand
GET
title

Request
headers

Authorization

Required

Legacy

https://api.boknett.no/metadata/export/object

The token acquired from the Authentication Service.

Formated "Boknett TGT-...."

Date

Required

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/

Formated "Bearer …"

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

Optional

See Pagination

Response
headers


Next

See Pagination

Link

See Pagination

Response
body

XML (Object metadata)

Returns

200

OK

400

Bad Request

401

Unauthorized

403

Forbidden

406

Not Acceptable

500

Internal Server Error

...