Datadeling (leganto-open-api)

Leganto-api er en tjeneste for å tilby exlibris sitt API for omverdenen. Noen av feltene fra Exlibris er sensitive, så denne tjenesten baserer seg på hvitelisting av felter som ikke er sensitive. Formatet, dersom ikke format-parameter er satt, er JSON. Se Exlibris sin dokumentasjon for en generell struktur på svar.

Basis-url: https://gw-unit.intark.uh-it.no/leganto-open-api

Endepunkter som støttes:

/courses - retrieve courses

/courses/{course_id} - retrieve course

/courses/{course_id}/reading-lists - retrieve reading lists

/courses/{course_id}/reading-lists/{reading_list_id} - retrieve reading list

/courses/{course_id}/reading-lists/{reading_list_id}/citations - retrieve citations

/courses/{course_id}/reading-lists/{reading_list_id}/citations/{citation_id} - retrieve citation

/courses/{course_id}/reading-lists/{reading_list_id}/citations/{citation_id}/tags retrieve tags

Det henvises til https://developers.exlibrisgroup.com/alma/apis/courses/# for generell dokumentasjon av API’et. Query-parametre som er støttet av Exlibiris skal også være støttet av leganto-api i den grad det er mulig.

Nødvendig parameter:

institution - navn på institusjon

Nåværende støttede institusjoner:

oslomet

hiof

ntnu

aho

dmmh

inn

himolde

hvl

hivolda

kristiania

ldh (Lovisenberg diakonale høgskole)

nord

nmbu

uia

uis

usn

vid

nhh

uio

uib

uit

mf

nla

Tips:

For å få stylet output i html kan query-parameter format settes til “html”.

Eksempel: https://gw-unit.intark.uh-it.no/leganto-open-api/courses/3566376300002212/reading-lists/3389970610002212/citations?institution=oslomet&format=html

For citations kan man i tillegg velge en CSL-style. Anbefalt er “apa” eller “ieee”. Dersom ingen style er valgt blir forhåndsdefinert (ikke CSL-offisiell) style brukt.

Eksempel: https://gw-unit.intark.uh-it.no/leganto-open-api/courses/3566376300002212/reading-lists/3389970610002212/citations?institution=oslomet&format=html&style=apa

For å få med citations i en reading list kan query-parameter view setter til “full”.

Eksempel: https://gw-unit.intark.uh-it.no/leganto-open-api/courses/3566376300002212/reading-lists/3389970610002212?institution=oslomet&view=full

Rate-begrensning:

Vi har vært nødt til å legge til begrensning på mangde innkommende trafikk. Akkrat nå er det satt til maks 5 forespørsel pr sekund. Dette kan justeres opp eller ned med tiden.