FBI-API

FBI-API giver andre systemer og tjenester ensartet og fleksibel adgang til en bred vifte af tjenester inden for det danske biblioteksområde. API’et er en del af den Fælles Biblioteksinfrastruktur, FBI. API’et giver adgang til metadata om biblioteker og deres samlinger samt tjenester som søgning, bestil og anbefalinger.

API’et er baseret på GraphQL, der blandt giver følgende fordele

• Et indbygget query language, der gør det muligt at angive præcist, hvilke data der skal hentes, så kun de ønskede data returneres.
• Adgang til mange forskellige ressourcer i en enkelt forespørgsel.
• Et typesystem, der udtrykker API’ets fulde funktionalitet og gør det muligt at udvikle effektive værktøjer, der understøtter udviklingsarbejdet.

Indgangen til FBI-API er https://fbi-api.dbc.dk/. Her findes udviklerværktøjer og dokumentation med en række eksempler på, hvordan API’et anvendes.

For at få adgang til at anvende FBI-API, skal man have adgang til den Fælles Biblioteksinfrastruktur. Dette har danske biblioteker samt andre parter, der har en aftale med et eller flere biblioteker.

Kontakt DBC DIGITALs kundeservice for at få etableret adgang til FBI-API. Henvendelsen skal indeholde følgende oplysninger:

• Projektejer (bibliotek, email, telefonnummer).
• Teknisk kontaktperson (navn, email, telefonnummer).
• Navn på og beskrivelse af projektet, FBI-API ønskes anvendt til.

FBI-API er grundigt dokumenteret på https://fbi-api.dbc.dk/documentation.

Når du som for eksempel udvikler har fået adgang til API’et, skal du kopiere et gyldigt token ind i feltet Drop token here…. Dokumentationssiden og den tilhørende venstremenu vil nu blive udvidet med detaljeret dokumentation af API’ets struktur og funktionalitet. Grunden til, at adgang til dokumentation kræver en gyldig API-adgang, er, at den blandt andet baserer sig på konkrete eksempler, der via dokumentationssiden kan afprøves mod API’et.

Dokumentationen her på PRO fungerer i nogle tilfælde som supplement og baggrund for informationen knyttet til selve API’et. Bemærk at det til enhver tid er API’et egen dokumentation, der er gældende.

• Under Søgemaskiner findes information om Simple Search og Complex Search, herunder en gennemgang af materialetyper og søgekoder der anvendes i Comlex Search.
• På Supplerende søgeværktøjer gennemgåes en række af de værktøjer, der kan bruges i samspil med søgemaskinerne til for eksempel anbefalinger og søgeforslag.
• JED beskriver det format, FBI-API udleverer bibliografiske poster i.