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.