Integraatiorajapinnat

Periaatteet integraatiorajapinnoille ja työnjaolle

Korkeakoulujen kanssa on sovittu seuraavista periaatteista työnjaon suhteen:

• Jos useampi järjestelmä yliopistossa käyttää samaa tietoa, se levitetään yliopiston sisällä kaikille näille integraatioalustalla
• Batch-kyselyihin tarjotaan REST/JSON-rajapintoja joihin korkeakoulu ottaa yhteyttä. Mikäli korkeakoulu tarvitsee ottaa yhteyttä muilla teknologioilla, se hoidetaan korkeakoulujen omilla integraatioalustoilla.
• Rajapinnat toteutetaan yksinkertaisuuden vuoksi pääsääntöisesti siten, että on tarjolla yksi import/export-rajapinta per objektityyppi, eikä objekteihin esimerkiksi sisällytetä erikseen haettavissa viitattuja objekteja tai tehdä muuta yliopiston kohdejärjestelmän vaatimaa räätälöintiä. Mikäli tiedon yhdistelyä tarvitaan, se hoidetaan yliopistojen omilla integraatioalustoilla.
• Lähetysten valvonnan ja virheisiin reagoinnin vastuu on yliopistoilla
• UniHow ei ole tarkoitettu arkistoksi, tietovarastoksi eikä raportointitietokannaksi, vaan näihin käytetään erillisiä ratkaisuja

Tunnistautuminen ja dokumentaatio

Kaikki rajapinnat käyttävät SSL-suojattua yhteyttä ja HTTP basic-autentikaatiota. Näiden lisäksi rajapintoihin on IP-rajoitus.

Integraatiotunnuksia voi pyytää Funidatan asiakaspavelusta (asiakaspalvelu(at)funidata.fi) kunkin korkeakoulun nimetty yhteyshenkilö. Tunnukset toimitetaan integraattorille turvallisella toimitustavalla.

Integraattoreille on luotu kaksi tunnusta, yksi sisääntulevalle (import) ja toinen ulosmenevälle rajapinnalle (export).

Swagger UI löytyy kustakin ympäristöstä osoitteesta: https://[ympäristön oma osa].funidata.fi/api-docs/

• Authorize painikkeella voi kirjautua integraatiotunnuksilla
• Jokaisessa asennuksessa olevat dokumentaatiot kuvaavat juuri sen asennuksen version rajapinnan