Henting av Marc poster fra Bokbasen

Arbeidskopi

 

Henting av Metadata fra Bokbasen gjøres på samme måte om det er Marc, Onix eller annet format og er beskrevet mer i detalj her: Export Service MARC

I alle requester mot bokbasen sine systemer kreves det at man sender med et autentiserings-token i en Authorization header. Hvordan man får dette er beskrevet mer i detalj under Authentication Service

Når man skal hente data fra Bokbasen må man alltid bruke et After eller et Next parameter.

After parameteret er et timestamp man kan bruke ved første gangs henting av data eller ved “påfylling” av data om man for eksempel har hatt nedetid eller mistet data. Da vil man få alle metadata som har hatt endringer siden det gitte tidspunktet. After parameteret vil man typisk bruke en gang og deretter basere seg på Next parameteret som man får tilbake ved hver request.

Når man spør Bokbasen sine metadatatjenester vil man alltid få tilbake et Next parameter. Dette parameteret skal man ta vare på og bruke neste gang man spør etter data. Dette gjør at man neste gang man spør får Marc poster med endringer siden forrige gang man spurte etter data.

Eksempel på flyt:

Man spør første gang etter metadata etter et gitt tidspunkt:

curl \ -H "Authorization: Bearer YOUR-TOKEN-HERE" \ https://api.bokbasen.io/metadata/export/marc/v1?after=20140109130000

Her kaller man Bokbasene sine APIer med et After parameter med et tidsformat Dette returnerer en respons med Marc poster som er endret etter gitt tidspunkt og en header med et Next token.

Next: MThmMTNjNWZkZGYjIzM4MzM2NjY1NjEzNDYyMzkyZDM0MzEzMjM5MmQzNDM4MzYzNTJkNjIzNzYzMzMyZDYyNjEzNDY2NjUzNTMyMzE2MjY1MzEzOTNhMzkzNzM4MzAzODM2MzQzNDMyMzYzMDMwMzA=

 

Dette tokenet vil man bruke til å spørre APIet med frem til man ikke lenger får flere poster. Dette betyr at det ikke er flere endringer å hente. Da tar man vare på det siste Next tokenet man fikk til neste gang.

 

Ved gitte intervaller spør man på nytt med det Next tokenet man lagret forrige gang og vil få endringer siden forrige gang man spurte og et nytt Next token man tar vare på til neste gang man skal spørre.

curl \ -H "Authorization: Bearer YOUR-TOKEN-HERE" \ https://api.bokbasen.io/metadata/export/marc/v1?next=MThmMTNjNWZkZGYjIzM4MzM2NjY1NjEzNDYyMzkyZDM0MzEzMjM5MmQzNDM4MzYzNTJkNjIzNzYzMzMyZDYyNjEzNDY2NjUzNTMyMzE2MjY1MzEzOTNhMzkzNzM4MzAzODM2MzQzNDMyMzYzMDMwMzA=