FOLIO Libris RTAC

En lånestatus-gateway som visar bibliotekets bestånd i Libris, med FOLIO som källa.

Vad tjänsten gör

Tjänsten besvarar Libris förfrågningar om lånestatus – den realtidskoll som i Libris webbsök visar om ett exemplar är inne eller utlånat. När någon tittar på en titel i Libris anropas Libris status-gateway (status.libris.kb.se), som i sin tur skickar förfrågan vidare till bibliotekets registrerade status-URL: den här tjänsten.

Förfrågan bär en identifierare (Bib_ID, ONR, ISSN eller ISBN). Tjänsten slår upp titeln i bibliotekets FOLIO och svarar med bestånd – placering, hyllsignum, lånestatus och eventuellt återlämningsdatum – som det XML-svar Libris förväntar sig. Hittas ingen träff returneras en Okänd-platshållare.

Mer om lånestatus och Biblioteksdatabasen finns i Kungliga bibliotekets dokumentation.

Så ansluter ert bibliotek

Varje bibliotek identifieras av sitt sigel. För att bli uppsatt:

  1. Ha ett FOLIO-tenant som tjänsten kan nå.
  2. Skapa en FOLIO-användare med enbart läsbehörigheter (bl.a. rtac.all samt läsrättigheter på inventory, holdings och items).
  3. Ta reda på vilka FOLIO identifier-type-UUID:n som motsvarar de identifierare ni vill kunna söka på (Bib_ID, ONR, ISSN, ISBN).
  4. Skicka ert sigel, FOLIO-uppgifter (okapi_url, tenant_id, användarnamn och lösenord) samt UUID:na ovan till tjänstens förvaltare.
  5. Förvaltaren lägger upp er. Anslutningen kan därefter verifieras på /<sigel>/validate-folio-connection.
  6. Registrera tjänstens status-URL för ert sigel i Biblioteksdatabasen hos KB, så att Libris anropar den.

När allt är på plats nås beståndskollen på /<sigel>/rtac?Bib_ID=<libris-id> (även ONR, ISSN och ISBN fungerar).

API-dokumentation

Interaktiv API-dokumentation finns på /docs (Swagger UI) och /redoc (ReDoc). Det maskinläsbara OpenAPI-schemat ligger på /openapi.json.

Anslutna bibliotek

Testa eller få tjänsten driftad

Vill ni prova tjänsten eller slippa drifta den själva? En färdig, driftad instans finns på https://rtac.bibliotekarien.se – testa den där, eller hör av er för att få ert bibliotek uppsatt och driftat. Vill ni drifta tjänsten själva hämtar ni källkoden på github.com/fontanka16/folio_libris_rtac.