Koppeling Mijn Bibliotheek - BE

Welkomstmail Mijn Bibliotheek (PCA)

Met een nieuwe inschrijving wordt er een welkomstbericht PCA / Mail gestuurd naar de nieuwe klant met daarin een registratielink met “patron system id” om zich hiermee aan te melden bij ‘Mijn Bibliotheek’. De registratielink verwijst naar https://mijn.bibliotheek.be en is (voorlopig) vastgelegd als optie in bctabel:

• Soort=AIN
• Kode=PCAURL
• Optie=mijn.bibliotheek.be

Als parameter wordt een zogeheten token samengesteld met onder andere een geheime code. Ook dit woord is (voorlopig) vastgelegd in bctabel:

• Soort=AIN
• Kode=PCAGHM
• Optie=mijn.bibliotheek.be

+-------+---------+---------------------+

| soort | kode | optie |

+-------+---------+---------------------+

| AIN | PCAURL | mijn.bibliotheek.be |

| AIN | PCAGHM | geheim |

+-------+---------+---------------------+

Het zgn. weblinkid is een kode (uuid) uit tabel actor_web_doorlink.

Authentiseren bij Wise vanuit Mijn Bibliotheek (PCB)

Vanuit Mijn Bibliotheek kan een bibliotheeklid zich aanmelden bij zijn of haar Wise-bibliotheek. Hiervoor is een aantal api-calls ontwikkeld waarmee vanuit Mijn Bibliotheek contact kan worden gelegd met het Wise-systeem. Om te beginnen moet het systeem inloggen in de restapi via de volgende url:  

https://cultuurconnect.wise.oclc.org/restapi/login.

Het authentiseren wordt uitgebreid toegelicht in de restapi-handleiding.

Zodra het inloggen in de restapi correct is verlopen kan worden vervolgd met het aanvragen van een one-time password (OTP) aan de hand van een aantal lenergegevens. Hierbij wordt een json request gestuurd naar de restapi van de Wise-server via de onderstaande url: https://cultuurconnect.wise.oclc.org...netimepassword. De opmaak van dit json request is als volgt:

{"libraryId":"I000","cardNumber":"1234567890","birthdate":"2000-01-01"}

Met headers wise_key en authorization (proxyToken)

• libraryId is het instantienummer van de bibliotheek.
• cardNumber is het pasnummer van de bibliotheekpas van het bibliotheeklid.
• Birthdate is de geboortedatum in formaat jjjj-mm-dd.

Bij een correct verzoek wordt de volgende respons gegeven:

{
"id": "",
"validationErrors": [],
"libraryId": "I000",
"birthdate": "2000-01-01",
"cardNumber": "1234567890",
"emailAddress": "a**b@c**d",
"expires": "2019-03-14T14:48:07"
}

Bij een foutief verzoek wordt een 404 error gegeven.

Aan de hand van de terugkoppeling kan de bibliotheekklant afleiden naar welk e-mailadres het bericht is verstuurd. De timestamp bij expires geeft aan tot wanneer het OTP geldig is. Zodra er bij Wise een correct OTP-verzoek binnenkomt wordt er een mail naar de betreffende actor verzonden, waarbij de zescijferige code het OTP is. (Deze mail is te zien onder de kop ‘Teksten en Stuurregels – PCB Bericht’.)

De klant moet dit OTP invullen in de webpagina van Mijn Bibliotheek, waarna er een nieuw json request verzonden moet worden naar dezelfde url: https://cultuurconnect.wise.oclc.org...netimepassword. De opmaak van dit json request is als volgt:

{"libraryId":"I000","cardNumber":"1234567890","birthdate":"2000-01-01" ,"oneTimePassword":"513802"}

Met headers wise_key en authorization (proxyToken)

• libraryId is het instantienummer van de bibliotheek.
• cardNumber is het pasnummer van de bibliotheekpas van het bibliotheeklid.
• Birthdate is de geboortedatum in formaat jjjj-mm-dd.
• oneTimePassword is het OTP dat de bibliotheekklant via de mail heeft ontvangen.

Bij een correct verzoek wordt de volgende respons gegeven:

{
"id": "",
"validationErrors": [],
"patronSystemId": "59844344d61f53453c2a3a77ef174a37",
"libraryId": "I000",
"birthdate": "2000-01-01",
"cardNumber": "1234567890",
"emailAddress": "a**b@c**d"
}

Bij een foutief verzoek wordt een 404 error gegeven.

Via het teruggekoppelde patronSystemId in combinatie met het libraryId kan de koppeling worden gemaakt tussen Mijn Bibliotheek en Wise.