Zo werkt de Wise API
Ooit afgevraagd hoe een website nou weet of jouw gereserveerde boek klaar staat, of hoe het werkt als je lid wordt van een bibliotheek? Dat gebeurt allemaal met een API (Application Programming Interface). Het gebruik van API's maakt het mogelijk om twee applicaties of computerprogramma's met elkaar te laten communiceren over het internet. Een API is dus eigenlijk een brug.
Waar wordt de Wise API voor gebruikt?
Elke dag wordt er meer dan een miljoen keer gebruik gemaakt van de Wise API's om websites, applicaties en processen mogelijk te maken. Niet alleen door Wise (zoals de Wisecat+, schoolWise of de Client), maar ook door externe partijen.
Voorbeelden:
- Inloggen met je bibliotheekaccount
- Het tonen van de bibliotheekcollectie
- Een carrousel met titels tonen op een scherm in de vestiging
- Exemplaren innemen, uitlenen en reserveren voor een circulatiemodule
- Synchronisatie met een CRM-systeem
Stappen om een nieuwe koppeling te realiseren
Welke stappen moet je dan doorlopen om een nieuwe koppeling te realiseren tussen een andere applicatie en Wise? We leggen je het stap voor stap uit.
Het verzoek indienen
Een POI, coöperatie, bibliotheek of derde partij doet een integratieverzoek voor Wise, bij voorkeur via Zendesk. Dit geldt voor nieuwe integraties en voor wijzigingen aan bestaande koppelingen.
Intakegesprek
Onze accountmanager Carola plant een intakegesprek met alle betrokken partijen en een afvaardiging van het Wise-productteam. Tijdens dit gesprek:
- vertelt de derde partij wat de gewenste functionaliteit is
- leggen wij uit wat het proces is voor toegang tot de API
Het gesprek vindt meestal plaats binnen drie weken na het verzoek, afhankelijk van ieders beschikbaarheid. Na het gesprek bepaalt de verzoekende partij of ze verder willen.
Technische haalbaarheid
OCLC controleert of er al bestaande koppelvlakken zijn met Wise. In veel gevallen is dit al zo. Dat is fijn, want dan zijn er geen aanvullende productontwikkelingen nodig voor Wise en kunnen we meteen door naar stap 4.
Als de koppelvlakken niet bestaan, maakt ons productteam een analyse van de benodigde tijd en capaciteit. We brengen in kaart wat er nodig is en bespreken met je wat de mogelijkheden zijn.
Is de koppeling veilig?
Wise verwerkt veel gegevens. Deze gegevens willen we zo goed mogelijk beschermen. Daarom vinden we het belangrijk dat de partij met wie we een koppeling maken de informatiebeveiliging ook goed op orde heeft.
Ze kunnen dit bij voorkeur aantonen met een ISO27001-certificaat. We kunnen dan meteen door met stap 5.
We leggen de afspraken vast in een overeenkomst
Voordat we de API-keys kunnen verstrekken, is er eerst een actuele overeenkomst nodig tussen de betrokken partijen en OCLC. Ook moet de bibliotheek, POI of coöperatie een formulier tekenen waarin precies staat vastgelegd welke toegang de derde partij krijgt.
De betrokken partijen tekenen de overeenkomst. Alleen een bevoegd persoon mag de overeenkomst ondertekenen, bijvoorbeeld de directeur van de organisatie.
Nu kun je aan de slag
Zodra de voorbereidingen zijn doorlopen en de API-keys beschikbaar zijn, verstrekken we deze aan de bibliotheek, POI of coöperatie. Dit zijn de 'sleutels' die de derde partij nodig heeft om de koppeling te realiseren. In de technische documentatie vinden ze alle informatie terug die ze nodig hebben.
Vragen of ondersteuning
Zijn er vragen of werkt er iets niet? Dan neemt de bibliotheek, POI of coöperatie contact met ons op via Zendesk.