Page History

Jotta Finna voidaan yhdistää Alman rajapintaan, tulee Almaan luoda API-avain osoitteessa . Alla on ohjeet avaimen luomiseksi ja toimivuuden tarkistamiseksi.

1. Mene selaimella osoitteeseen https://developers.exlibrisgroup.com/manage/keys/

...

1. ja kirjaudu sisään kirjastosi tunnuksilla (tunnukset tulevat Ex Librikseltä)

2. Lisää avain ja anna sille seuraavat käyttöoikeudet:

   Info
   Kaikki oikeudet lisätään yksittäiselle avaimelle Add Permission -painikkeella (merkitty kuvaan nuolella).

   • Bibs - Production Read/write
   • Users - Production Read/write
   • Configuration - Production Read-only
     
     Image Modified

Välittäkää tieto avaimesta Finnan palveluosoitteeseen [email protected] turvallisesti esim. käyttäen turvapostia: https://securemail.helsinki.fi.

1. Tarkista, että luotu avain toimii. Helpoin tapa on kokeilla yksinkertaista bib-hakua selaimella. Alla olevassa esimerkissä on malliksi Ex Libriksen testipalvelimen avain. Vaihda

...

1. apikey-kohtaan lisäämäsi avain ja avaa linkki selaimella:
   https://api-eu.hosted.exlibrisgroup.com/almaws/v1/bibs?mms_id=123&apikey=l7xx2af7939c63424511946e0fcdc35fe22a
   
   Osoitteen pitäisi palauttaa yksinkertainen vastaus:
   

...

1. <bibs/>
   
   Jos palvelin pyytää kirjautumista

...

1. , tai tulee virhe esim. reitityksen puuttumisesta,

...

1. ota yhteys Ex Libriksen tukeen reitityksen korjaamiseksi.
   
   Avainta voi myös testata developers.exlibrisgroup.com:n API Console -kohdassa.
   
   
2. Lähetä avaimen tiedot Finnan palveluosoitteeseen [email protected] turvallisesti esim. käyttäen turvapostia: https://securemail.helsinki.fi.