Noutorajapinnan kuvaus ja ohjeistus

Työmarkkinatori-palvelualustalla on työnhakuprofiileihin liittyvä ohjelmallinen rajapinta (API), jonka kautta käyttäjä voi noutaa Työmarkkinatorilla olevia työkokemukseen ja osaamiseen liittyviä tietoja osaksi toisessa palvelussa olevaa profiilia. Rajapinta tarjoaa teknisen mahdollisuuden tietojen noutamiseen. 

Rajapinnan käyttöoikeus on sidottu organisaation Y-tunnukseen. Tietojen noutaminen Työmarkkinatori-palvelualustalta toisiin palveluihin perustuu käyttäjän antamaan luvitukseen. 

Työnhakuprofiilin tiedot siirtyvät kertaluonteisesti Työmarkkinatori-palvelualustalta noutorajapinnan kautta tietoja noutavan organisaation palveluun. Työnhakuprofiilin tietoja voi kuitenkin noutaa myös osissa, mutta jokaiseen kertaan liittyy erillinen tietojen luvittaminen. Työnhakuprofiiliin liittyvät tiedot noudetaan ulkoiseen palveluun rajapintakuvauksen mukaisessa muodossa.  

Työmarkkinatorilta noudetaan vain ne tiedot, jotka käyttäjä luvittaa siirrettäväksi, muita tietoja ei noudeta. Kun työnhakuprofiiliin liittyvät tiedot on noudettu Työmarkkinatorilta, niiden hallinta on tehtävä ulkoisessa palvelussa. Työnhakuprofiilin tietoja voi myös tämän jälkeen päivittää Työmarkkinatorilla, mutta päivitetyt tiedot eivät automaattisesti synkronoidu siihen palveluun, jonne profiilitiedot on aiemmin noudettu.   

Noutorajapinnan käyttöönoton vaiheet 

1. Rajapinnasta kiinnostunut organisaatio tutustuu Työmarkkinatorin työnhakuprofiilien noutorajapinnan kuvaukseen, käyttöehtoihin ja tekniseen ohjeeseen. 
2. Rajapinnan käyttöönsä ottava organisaatio toimittaa tarvittavat tiedot KEHA-keskukselle käyttöönottoilmoitus-lomakkeella. Samalla lomakkeella sitoudutaan myös käyttöehtojen noudattamiseen. 
3. KEHA-keskus tarkistaa organisaation oikeuden ja soveltuvuuden rajapinnan käyttöön. 
4. Tarkistuksen jälkeen KEHA-keskus toimittaa käyttäjätunnukset rajapinnan käyttöönottavalle organisaatiolle. 
5. Rajapinnan käyttöönotto on kaksivaiheinen. Ensimmäisessä vaiheessa KEHA-keskus toimittaa tunnukset aina Työmarkkinatorin testiympäristöön ja tekee tarvittavat yhteysavaukset sinne. Ennen tuotantoympäristön avaamista rajapintaa tulee aina yhteistestata KEHA-keskuksen kanssa.  
6. Kun rajapinnan käyttöönottava organisaatio on testannut rajapinnan toimivuuden yhdessä KEHA-keskuksen kanssa, voidaan organisaatiolle toimittaa tunnukset tuontirajapinnan tuotantoympäristöön.