Dansk

PLAS API · Public Library API Specification

Bibliotekets data bag én fælles standard

Digitale bibliotekstjenester skal kunne udvikles på tværs af systemer og datakilder — uden at hver løsning bygger og vedligeholder sine egne integrationer.

Illustration af et bibliotekssystem der udveksler data med apps, brugere og tjenester gennem én fælles grænseflade

Modellen

Ét lag mellem kilden og produkterne

Kilden implementerer Provider API og eksponerer sine data, og produkterne kalder den samme grænseflade. Skal kilden selv vide noget, går det den anden vej gennem Vendor API.

Referencen

To indgange, én fælles specifikation

Provider API er det bibliotekssystemet stiller til rådighed. Vendor API er den anden vej — det produktet stiller til rådighed tilbage. Search og Content er profiler af Provider, som kan implementeres for sig.

  • Illustration af et API beskrevet som kode i et vindue, koblet til de tjenester der bruger det

    Provider API

    v0.6.5 · 22 grupper · 54 operationer · 379 skemaer

    Bibliotekssystemets egen grænseflade — lånere, lån, reserveringer, betaling og beholdning. Implementeres af bibliotekssystemet, kaldes af produkterne.

  • Illustration af kodevinduer i lag: en flade bygget oven på en fælles specifikation

    Vendor API

    v0.6.5 · 3 grupper · 3 operationer · 152 skemaer

    Den flade produktet selv stiller til rådighed, så bibliotekssystemet kan sende events og fuldføre låner-login. Implementeres af leverandøren, kaldes af systemet.

Princippet

PLAS standardiserer adgangen — ikke systemerne

Kilderne bliver ved med at være forskellige. Det er vejen ind til dem, der bliver ens.

Bibliotekerne skal ikke skifte system for at få gavn af standarden. PLAS lægger sig oven på det, biblioteket allerede bruger, og gør adgangen til data og funktioner den samme på tværs.

  • Specifikationen

    REST og JSON med en maskinlæsbar beskrivelse

    Bibliofil, Cicero eller Koha kan have hver sin løsning underneden — applikationen ovenpå møder den samme grænseflade. Referencen her genereres af OpenAPI-filerne, version for version, så et bibliotek kan skrive én bestemt ind i et udbud.

  • Domænerne

    Otte områder, udrullet ét ad gangen

    Søgning, bibliografiske data, beholdning, lånerdata, cirkulation, fjernlån, digitale medier og fælles services som identitet, single sign-on og betaling. Hvert område er beskrevet for sig med egne operationer og svar, og bibliotekssystemet implementerer dem når det giver mening.

  • Kom i gang

    Åben dokumentation og en gennemsigtig proces

    Base-URL, autentificering og det første kald — alt du skal vide før du kalder et bibliotekssystem. Standarden begynder med de vigtigste fælles funktioner og udvides efter behov fra biblioteker og leverandører, ikke efter en plan lagt på forhånd.

Hvem gør hvad

  • Biblioteker

    Bidrager med behov og eksempler fra hverdagen.

  • Systemleverandører

    Implementerer specifikationen og er med til at forme den.

  • Dataleverandører

    Gør deres data og tjenester tilgængelige gennem standarden.

  • Udviklere

    Bygger nye tjenester oven på og foreslår forbedringer.

Hvad standarden giver

Én standard, seks konkrete gevinster

I dag har bibliotekssystemer, metadata, søgning, digitale medier, arrangementer, identitet og betaling hver sin integrationsgrænseflade. PLAS samler adgangen ét sted — og det ændrer hverdagen for både biblioteker og leverandører.

Udvikler i profil ved en stor skærm i et åbent kontorlandskab, med en kollega i arbejde i baggrunden

Bliv en del af PLAS

En standard bliver stærk, når mange bruger den

PLAS skal udvikles af sektoren, for sektoren — ikke af én leverandør alene.

Kom i gang med PLAS

Redia foreslår PLAS og vedligeholder dokumentationen her — men standarden tilhører sektoren. Start med det første kald, eller skriv til os hvis I vil være med til at forme den.