Biblioteksdatabasens API
Via ett API går det att hämta information ur Biblioteksdatabasen. Du kan få information om ett enskilt bibliotek eller listningar på samtliga bibliotek.
All data som finns i databasen är tillgänglig via API:et. Data om kontaktuppgifter kräver dock att du skickar med en API-nyckel som extra header i anropet. Kontakta Libris kundservice om du behöver en API-nyckel.
API:ets URL är http://bibdb.libris.kb.se/api/lib
Länk till annan webbplats. och accepterar följande parametrar:
| Namn | Värden | Beskrivning |
|---|---|---|
| Sigel | Sigler för den/det bibliotek som visas. | Hämtar ett eller flera bibliotek med angiv(et/na) sig(el/ler). |
| ocode | Organisationskod för den samling sigler som ska visas. | Hämtar samtliga bibliotek inom en organisation. |
| dump | true | Listar samtliga bibliotek |
| updated | Datum enligt YYYY-MM-DD | Laddar samtliga bibliotek som uppdaterats sedan angivet datum. |
| start | Heltal | Börja listningen från denna position |
| n | Heltal | Visa max detta antal bibliotek i listningen. (Default 200) |
| level | full | brief | Avgör hur mycket information som ska visas per bibliotek. (Default full) |
Vill du begränsa listan ytterligare kan du ange nyckelvärde-par som parametrar till frågan (se nedan).
Exempel
Information om ett särskilt bibliotek
- För att få information om ett särskilt bibliotek anger man dess sigel som parameter:
http://bibdb.libris.kb.se/api/lib?sigel=S Länk till annan webbplats.
Information om flera bibliotek
- Ange flera sigler för att hämta information om flera bibliotek:
http://bibdb.libris.kb.se/api/lib?sigel=S,H Länk till annan webbplats.
Information om samtliga bibliotek
- För att hämta samtliga bibliotek inom en organisation kan man ange organisationskoden som parameter.
http://bibdb.libris.kb.se/api/lib?ocode=KB Länk till annan webbplats.
Parametrarna “ocode” och “sigel” går också att kombinera.
Lista på uppdaterade bibliotek
- Vill man få en lista på de bibliotek som uppdaterats sedan ett visst datum kan man använda parametern “updated”:
http://bibdb.libris.kb.se/api/lib?updated=2013-06-01 Länk till annan webbplats. - Eller vill man ha alla bibliotek så kan man använda “dump”-parametern:
http://bibdb.libris.kb.se/api/lib?dump=true Länk till annan webbplats.
Begränsa urval
- För att begränsa sitt urval till ett visst värde, till exempel enbart svenska bibliotek kan man använda nyckeln för land (country_code), i frågan:
http://bibdb.libris.kb.se/api/lib?dump=true&country_code=se Länk till annan webbplats. - Ett annat exempel, för att begränsa till bibliotek i Stockholm:
http://bibdb.libris.kb.se/api/lib?dump=true&address.city=stockholm Länk till annan webbplats.