fullskärmsbild

Användning av Libris API:er

Här redovisas de tillgängliga API:er som finns i Libris.

Samtliga ingångar är API:er som körs över HTTP.

De flesta av API:erna kräver auktorisering vilket sker genom Libris loginlänk till annan webbplats som är kopplat till ett personligt konto. Rättighetshanteringen sköts med hjälp av OAuth2länk till annan webbplats.

När användaren är auktoriserad får denna en så kallad token som ska följa med som en parameter för alla processer som kräver auktorisering. Om ett sådant anrop besvaras med ”401 Unauthorized“ så innebär det att rättigheter för att utföra uppgiften saknas eller är ogiltiga. Kontakta Libris kundservice för hjälp.

Det finns två olika nivåer av rättigheter:

  1. Nivå 1 för hantering av enbart beståndposter
  2. Nivå 2 för hantering av både bibliografiska poster och beståndsposter
  • API-ingången för att lista bestånd är /_findhold och till detta behöver man två parametrar som båda är URI:er.

    1. Den bibliografiska postens ID (id)
    2. Sigel (library).

    Svaret på detta anrop är en URI med postens beståndsuppgifter för sigeln.

    Exempel:
    /_findhold?id=http://libris.kb.se/bib/1234&library=https://libris.kb.se/library/SEK

  • API-ingången för att slå samman två poster är /_merge och de parametrar som krävs är id1 och id2 vilket är de två posternas URI:er.

    Standardinställningen är att posten med id1 är den som blir kvar efter sammanslagningen. Vill man ändra detta måste parametern promote_id2 till true anges.

    För att förhandgranska sammanslagningen skickar man ett GET-anrop till API-ingången. Om man skickar ett POST-anrop genomförs sammanslagningen och posten sparas i databasen. POST-anropet kräver auktorisering och att man skickar sin token i header-taggen Authorization.

    Exempel:
    /_merge?id1=http://libris.kb.se/bib/1234&id2=http://libris.kb.se/bib/7149593&promote_id2=false
  • API-ingången för att lista beroenden är ”/_dependencies ” och parametern som krävs är ”id” det vill säga postens URI som man skickar med ett GET-anrop. Vad som returneras är en eller flera URI:er som pekar på beroenden som språk, land, katalogiseringstyp mm. Man kan också ange parametern ”relation” för att specificera vilket beroende man vill ha svar på.

    Man kan även lägga till parametern ”reverse” - satt true eller false - för att lista vilka beroenden som saknas.

    Exempel:
    /_dependencies?id=http://libris.kb.se/bib/1234&relation=language&reverse=false

  • API-ingången för denna funktion är ”/_compilemarc” och kräver två parametrar. Dels ”id” vilket är postens URI samt ”library” vilket är sigelns URI. Då får man en bibliografisk marcpost med sammanslaget bestånd och beståndsinformationen är kodad med ett inledande delfält $5 [Sigel].

    Exempel:
    /_compilemarc?id=http://libris.kb.se/bib/1234&library=https://libris.kb.se/library/SEK

  • API-ingången för sökningar internt i XL är /find och parametern för sökfrågan är q.
    Frågespråk och sökkoder är samma som i gränssnittet till Libris katalogisering och en närmare beskrivning av dessa hittar du i Libris katalogiseringsgränssnittets sektion Hjälp.

    Ytterligare parametrar är _limit vilket är en begränsning av antalet träffar (standardvärde för detta är 200) samt _offset vilket talar om hur många poster i sökresultatet som ska hoppas över. Detta används för bläddring och standarvärdet är 0.

    Exempel:
    /find?q=tove jansson&_limit=50&_offset=0

  • API-ingången /_convert  används för att med ett POST-anrop skapa och visa en testkonvertering till MARC21 av ett JSON-LD dokument. Förutom auktorisering så krävs följande header-taggar: Content-type satt till application/ld+json, Accept satt till application/x-marc-json när man postar dokumentet.

Kontakt
Libris kundservice E-post: libris@kb.se Telefon: 010-709 30 60 Fler kontaktuppgifter och telefontider
Tyck till

Hjälpte den här sidan dig?