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