[Dit artikel gaat niet in op de algemene principes van API’s en koppelingen. Zie daarvoor deze pagina. Dit artikel bevat vooral voorbeelden.]
Allerlei REST/JSON-API’s
De V-applicaties beschikken over vele API’s. De meeste van deze API’s volgen de syntaxis van derden (3rd parties). Voorbeelden van beschikbare API’s zijn:
- Iguana Rest-API (IguanaXgateway: dit is de servicelaag waarmee front-endapplicaties content kunnen ophalen uit V-smart en zo data en services kunnen aanboren. IguanaXgateway bestaat uit een aantal services; dit zijn technische services en ze hebben geen gebruikersinterface. Als zodanig geeft IguanaXgateway toegang tot functionaliteit zoals zoeken, reserveren en verlengen via een programmatorische interface. Een aanvragende front-endapplicatie krijgt via webservices toegang tot de servicelaag. De servicelaag (die eigenlijk IguanaXgateway is) verwerkt de aanvraag, linkt naar een back-endapplicatie (de “server”) om toegang te krijgen tot functies en/of gegevens op te halen, vertaalt het antwoord naar JSON (het technische formaat) en stuurt het terug naar de client.)
- CRMAPI – voor het synchroniseren van lenersdata met een 3rd party
- WebPower API (synchronisatie van lenergegevens voor WebPower / Spotler)
- ARENA bibliografische en lener-API
- BICATWISE API voor het importeren van bibliografische records
- Google XML API voor integratie van de link resolver in Google Scholar
- diverse API’s voor het importeren van leners (LudikAPI, ROCAPI)
e.a.
Verdere voorbeelden van koppelingen
De bovenstaande API’s zijn vrijwel alle zgn. REST/JSON-API’s. Deze API’s worden gebruikt voor koppelingen met vele applicaties. Verdere voorbeelden van koppelingen zijn:
- Het SIP2-protocol wordt gebruikt voor koppelingen met o.a. lendomaten, sorteerrobots en/of betaalstations van 3M, KnoTech, NEDAP Librix, AutoCheck, HSBIB, Bibliotheca, I-Track, Libramation, Intellident, BeeSmart, Xafax en EastBridge.
- CAMT is in gebruik bij Bibliotheek Den Haag.
- Er zijn pakweg tien API’s in gebruik voor het verzenden van SMS-berichten.
- Data die in V-smart wordt beheerd bij o.a. Groninger Forum, Theek5 en Nieuwe Veste (MFO in Breda) wordt getoond in een niet door Axiell geleverde website. (Bibliotheek Breda maakt deel uit van Nieuwe Veste; Nieuwe Veste heeft een eigen website, die gebruik maakt van geharveste data; de bibliotheek heeft daarnaast een eigen Iguana-website die is vormgegeven door een combinatie van een externe partij en bibliotheekmedewerkers.)
- Enkele bibliotheken die gebruik maken van andere zoekinterfaces zijn bijv. Bayonne, Kalambaka en Veroia (Europeana); Quimper (Gallica), OBA (AquaBrowser) en ZB Bibliotheek van Zeeland (WorldCat). (De collectie van deze bibliotheken is dus óók opgenomen in andere catalogi.)
- De landelijke koppelingen data warehouse, IBLV, Single Identity e.a. zijn in gebruik bij vrijwel alle Nederlandse openbare bibliotheken die V-smart gebruiken. Hetzelfde geldt voor de koppeling met NBD-services.
- Essentieel is dat koppelingen ook in nieuwe versies worden ondersteund; kortom, de ontwikkelingen zijn geborgd (opname in nieuwe versies) en hoogstens slechts tijdelijk “lokaal”.
- Koppelingen kunnen vaak op diverse manieren worden gerealiseerd: [1] niet, [2] door een oplossing uit het V-portfolio, [3] door een beschikbare koppeling met een “3rd party” product of [4] door een nog te ontwikkelen koppeling. Met iedere oplossing gaan andere kosten gepaard.
Hoe komen koppelingen tot stand?
Dergelijke koppelingen kwamen in het verleden op diverse manieren tot stand. Enkele voorbeelden.
- De koppeling met Olifantenpaadje is gerealiseerd op eigen Axiell-initiatief. Olifantenpaadje kan stand-alone worden gebruikt, maar Axiell biedt ook een koppeling op basis van door Olifantenpaadje beschikbaar gestelde API’s.
- Voor sommige koppelingen loopt dat echter geheel anders. Zo zijn er diverse “landelijke koppelingen” (Gastlenen, NBC+, data warehouse, IBLV, Single Identity).
- Vele koppelingen zijn ontstaan op initiatief van individuele klanten of gebruikersgroepen. Elk kwartaal is er “Innovatieoverleg” bij Sambis (Gelderse en enkele Overijsselse bibliotheken), waaraan de basisbibliotheken kunnen deelnemen. De ontwikkeling van de koppeling met HelloDialog is o.a. ook hier geïnitieerd. Een ander voorbeeld is de koppeling met Smart Connections.
- Nog een voorbeeld is authenticatie. Dit impliceert ook SSO (Single Sign-On) en kan niet alleen verlopen via protocollen en toepassingen als bijv. CAS, ADFS of (heden ten dage vooral) Azure AD (operationeel bij o.a. diverse Nederlandse Hogescholen), maar ook via “gemeentelijke” multidisciplinaire kaarten. Een (Frans) voorbeeld is de Carte ATOUT, die in Angers gebruikt wordt in de bus, in het zwembad, in de bibliotheek, enz. Het principe is gelijk: er is één centrale directory van gebruikers.