Tällä sivulla on kuvattu miten alustan rajapintoja voidaan hyödyntää ulkopuolisissa integraatioissa, kuten koodistojen, tietomallien tai sanastojen lataamisessa omaan tietojärjestelmään tai aineistojen automaattiseen päivittämiseen yhteentoimivuusalustalle.
Tokenin tilaaminen
Rajapintoja voidaan käyttää JWT-tokenin avulla, joka voidaan tilata ryhmienhallintapalvelusta (https://rhp.suomi.fi) käyttäjätietojen alta:
Tilattu token näytetään tokenia luotaessa vain kerran, mutta sen voi tarvittaessa poistaa ja luoda uudelleen.
Rajapintojen Open API kuvaukset
| Sovellus | Kuvaus | Linkki |
|---|---|---|
| Tietomallit | Tietomallit-sovelluksen API -kuvaus | https://tietomallit.suomi.fi/swagger/ |
| Koodistot | Koodistot-sovelluksen API -kuvaus | https://koodistot.suomi.fi/swagger/ |
| Sanastot | Sanastot-sovelluksen API -kuvaus | https://sanastot.suomi.fi/swagger/ |
Harmonoisoidut rajapinnat
Kaikissa sovelluksissa on harmonisoitu Integration-rajapinta, jonka avulla voidaan hakea tietosisältöjen perustietoja samassa formaatissa. Integration API:t tukevat sekä GET että POST tyyppisiä kyselyjä, joiden avulla alustalta voidaan kysellä lista kaikista tuotoksista (Containers) ja niissä määriteltävistä resursseista (Resources).
Containers API - /api/v1/integration/containers
Listaa kaikki julkaistut tuotokset (containers).
Resources API - /api/v1/integration/resources
Listaa kaikki tuotoksissa julkaistut resurssit (resources).