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

  1. Mene selaimella osoitteeseen https://developers.exlibrisgroup.com/manage/keys/ ja kirjaudu sisään kirjastosi tunnuksilla (tunnukset tulevat Ex Librikseltä)

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

    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

  3. Tarkista, että luotu avain toimii. Helpoin tapa on kokeilla yksinkertaista bib-hakua selaimella. Alla olevassa esimerkissä on malliksi Ex Libriksen testipalvelimen avain. Vaihda 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:
     <bibs/>

    Jos palvelin pyytää kirjautumista, tai tulee virhe esim. reitityksen puuttumisesta, ota yhteys Ex Libriksen tukeen reitityksen korjaamiseksi.

    Avainta voi myös testata developers.exlibrisgroup.com:n API Console -kohdassa.

  4. Lähetä avaimen tiedot Finnan palveluosoitteeseen [email protected] turvallisesti esim. käyttäen turvapostia: https://securemail.helsinki.fi.