PLAS API · Public Library API Specification

Bibliotekets data bak én felles standard

Digitale bibliotektjenester skal kunne utvikles på tvers av systemer og datakilder — uten at hver løsning bygger og vedlikeholder sine egne integrasjoner.

Illustrasjon av et bibliotekssystem som utveksler data med apper, brukere og tjenester gjennom ett felles grensesnitt

Modellen

Fra fragmenterte integrasjoner til ett felles lag

Uten en felles standard trengs en egen integrasjon for hver kobling. Med PLAS implementerer kilden Provider API-et én gang, og alle tjenester kaller det samme grensesnittet.

Referansen

To innganger, én felles spesifikasjon

Provider API er det bibliotekssystemet stiller til rådighet. Vendor API er den andre veien — det tjenesten stiller til rådighet tilbake. Search og Content er profiler av Provider som kan implementeres for seg.

  • Illustrasjon av et API beskrevet som kode i et vindu, koblet til tjenestene som bruker det

    Provider API

    v0.6.7 · 22 grupper · 59 operasjoner · 420 skjemaer

    Bibliotekssystemets eget grensesnitt — lånere, lån, reservasjoner, betaling og beholdning. Implementeres av bibliotekssystemet, kalles av tjenestene.

  • Illustrasjon av kodevinduer i lag: en flate bygget oppå en felles spesifikasjon

    Vendor API

    v0.6.7 · 3 grupper · 4 operasjoner · 153 skjemaer

    Flaten tjenesten selv stiller til rådighet, slik at bibliotekssystemet kan sende hendelser og fullføre single sign-on. Implementeres av tjenesten, kalles av systemet.

Prinsippet

PLAS standardiserer tilgangen — ikke systemene

Kildene fortsetter å være forskjellige. Det er veien inn til dem som blir lik.

Bibliotekene skal ikke bytte system for å få nytte av standarden. PLAS legger seg oppå det biblioteket allerede bruker, og gjør tilgangen til data og funksjoner den samme på tvers.

  • Spesifikasjonen

    REST og JSON med en maskinlesbar beskrivelse

    Bibliofil, Cicero eller Koha kan ha hver sin løsning under — tjenesten oppå møter det samme grensesnittet. Referansen her genereres fra OpenAPI-filene, versjon for versjon, så et bibliotek kan skrive én bestemt inn i en anskaffelse.

  • Domenene

    Bibliotekets domener, ett om gangen

    Søk, bibliografiske data, beholdning, lånerdata, sirkulasjon, fjernlån, digitale medier, arrangementer og felles tjenester som identitet, single sign-on og betaling. Standarden kan bygges ut gradvis til å omfatte dem alle — funksjonene viser hva som er støttet i dag.

  • Kom i gang

    Åpen dokumentasjon fra første kall

    Base-URL, autentisering og det første kallet — alt du må vite før du kaller et bibliotekssystem. Hver versjon ligger åpent med sin OpenAPI-fil, og standarden utvikles på bakgrunn av behov og innspill fra bibliotek og leverandører.

Hvem gjør hva

  • Bibliotek

    Kan bidra med behov, brukstilfeller og krav til tjenestene.

  • Systemleverandører

    Kan implementere spesifikasjonen og være med på å forme den.

  • Dataleverandører

    Kan gjøre data og tjenester tilgjengelige gjennom standarden.

  • Utviklere

    Kan bygge nye tjenester oppå og foreslå forbedringer.

Hva standarden gir

Én standard, seks konkrete gevinster

Bibliotekssystemer, metadata, søk, digitale medier, arrangementer, identitet og betaling har ofte hvert sitt integrasjonsgrensesnitt. PLAS samler tilgangen bak én felles standard — og det endrer hverdagen for både bibliotek og leverandører.

Utvikler i profil ved en stor skjerm i et åpent kontorlandskap, med en kollega i arbeid i bakgrunnen

Visjonen

Ett åpent digitalt økosystem for bibliotek

Målet er ikke å bestemme hvilke systemer bibliotekene bruker, men å gjøre det mulig å koble dem sammen. PLAS skal utvikles av sektoren, for sektoren — og endringsforslag er velkomne.