Licenties Wisecat+
OCLC Wise
Voor het gebruik van Wisecat zijn de licenties LIC_WISECAT en LIC_WISECATPLUS benodigd.
- hoofdgroep: W - Web
- groep: Y - Web licenties
- licentie: LIC_WISECAT
- licentie: LIC_WISECATPLUS
De licenties moeten worden ingesteld via SysteemWise > Systeem- en automaatlicenties.
API's en API-key NBC+
De Wisecat+ zoekt zowel in OCLC Wise als in de NBC+. Voor de titels uit OCLC Wise wordt een interne zoekmachine bevraagd; voor de titels uit de NBC+ wordt de NBC+ API bevraagd. Via die API kan de Wisecat+ het aanbod van de NBC+ dus ontsluiten.
Wat is een API
API = Application Programming Interface. Een API is een set aan definities waarmee softwareprogramma's onderling kunnen communiceren. Het dient als een interface tussen verschillende softwareapplicaties waardoor de gebruikte code automatisch elkaar toegang tot informatie en/of functionaliteit geeft, zonder dat ontwikkelaars hoeven te weten hoe het andere programma exact werkt. API's bestaan voor (web)applicaties, softwarebibliotheken en besturingssystemen en kunnen voor allerlei doeleinden worden ingezet. Zo gebruikt een besturingssysteem een API om softwareprogramma's in de gelegenheid te stellen om bijvoorbeeld te kunnen printen en kun je via een API van een internetapplicatie bijvoorbeeld teksten, foto's en video over de hele wereld binnenhalen en/of versturen.
(Bron: Computerworld.nl)
Daarnaast bestaan er 'API-keys'. Om van de NBC+ API gebruik te kunnen maken, is zo'n API-key nodig. Deze kan 'default' zijn voor alles of per instantie of vestiging.
Een NBC+ API-key bestaat uit hele reeks aantal cijfers en letters, die niet zo maar te raden zijn, bijv. 3eac82c4-aa11-43cd-9e33-bab43f497944. De KB zal in eerste instantie een API-key voor de acceptatieomgeving van de NBC+ opleveren. Om de key voor een productieomgeving te kunnen gebruiken, moet deze daarvoor geschikt gemaakt worden. Dit moet expliciet worden aangevraagd.
NBC+ api | Token voor coverservice instellen
De NBC+ coverservice is afgeschermd met een 'token'.
In de Wisecat+ roepen we deze coverservice aan voor covers van de titels die we in de NBC+ vinden. Wanneer gebruik wordt gemaakt van de NBC+ zonder in te stellen welk token richting de coverservice gebruikt moet worden, dan toont de Wisecat+ voor de NBC+titels GEEN covers meer. De OCLC Wise-programmatuur (bxmcgi) is aangepast zodat deze een token ondersteunt.Om de covers in de NBC+ getoond te krijgen moeten onderstaande 4 stappen worden uitgevoerd:
Stap 1: Aanvragen token voor de NBC+ coverservice
Elke klant moet een eigen token opvragen door een url aan te roepen en zijn eigen NBC+ apikey mee te geven:
https://v112.nbc.bibliotheek.nl/token?apikey=<api-key>
Als 'antwoord' krijgt u een 'token', bijv. 8c0ede6b
Stap 2: Token instellen
Op de webserver moet in /etc/bng.d/getmomimg.cfg worden opgegeven welk token gebruikt moet worden voor de NBC+ coverservice.
Bijvoorbeeld:
$cfg = {
# ...
'NBCPLUS_COVERSERVICE_TOKEN' => '8c0ede6b',
# ...
};
1;
Stap 3: Instellen dat de Wisecat+ gebruik gaat maken van NBC+
Verander op de webserver de Wisecat+configuratie in /etc/bng.d/bicatcgi.conf ALLE endpointkeys in het OSEARCH blok (voeg aan alle endpointkeys het versienummer toe):
'endpoint' => ' https://v112.nbc.bibliotheek.nl '
Stap 4: Apache herstarten
Na herstart worden de nieuwe instellingen actief.
API-key filters
De NBC+ kent sinds versie 1.8 de mogelijkheid om API-key filters te laten maken. Dit zijn filters die een naam hebben en een voorselectie maken uit de catalogus. Het is het NBC+ antwoord op de wisecat+ zoekhulp selecties.
NBC+ API-key filters kunnen in de zoekhulp-configuratie genoemd in het veld 'preset'. De preset kent al enkele gereserveerde waarden: ‘articles’, ‘books’, ‘all’, ‘ebooks’, ‘delpher’, ‘tresoar’, ‘passend_lezen’, ‘athenaeumbibliotheek’, ‘ebook_platform’, ‘gutenberg’, ‘muziekwebplein’, ‘uittrekselbank ’.
De API-key filters in de NBC+ mogen niet dezelfde naam hebben als deze gereserveerde waarden. Dit houdt in dat OCLC Wise alleen API-key filters ondersteunt die een andere schrijfwijze hebben dan bekende presets.