Tuontirajapinnan kuvaus ja ohjeistus

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

Rajapinnan käyttöoikeus on sidottu organisaation Y-tunnukseen. Tietojen tuominen ulkoisista järjestelmistä Työmarkkinatori-palvelualustalle perustuu käyttäjän antamaan luvitukseen.

Työnhakuprofiilin tiedot siirtyvät kertaluonteisesti tietoja tuovan organisaation palvelusta Työmarkkinatori-palvelualustalle tuontirajapinnan kautta. Työnhakuprofiilin tietoja voi kuitenkin tuoda myös osissa, mutta jokaiseen kertaan liittyy erillinen tietojen luvittaminen. Työnhakuprofiiliin liittyvät tiedot on tuotava Työmarkkinatorille rajapintakuvauksen mukaisessa muodossa. Ulkoisessa palvelussa olevien työkokemus ja omaamistietojen muuttaminen Työmarkkinatorin käyttämään muotoon on ulkoisen järjestelmän vastuulla. Työmarkkinatori ottaa vastaan vain ne tiedot, jotka käyttäjä luvittaa siirrettäväksi, muut tiedot jätetään käsittelemättä. Kun työnhakuprofiiliin liittyvät tiedot on tuotu Työmarkkinatorille, niiden hallinta on tehtävä Työmarkkinatorilla. Työmarkkinatorille tuotujen työnhakuprofiilitietoja voi myös päivittää Työmarkkinatorilla, mutta päivitetyt tiedot eivät synkronoidu siihen palveluun, josta ne on alun perin tuotu. 

Tuontirajapinnan käyttöönoton vaiheet

  1. Rajapinnasta kiinnostunut organisaatio tutustuu Työmarkkinatorin työnhakuprofiilien tuontirajapinnan 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. 

Kaikki rajapintoja koskevat yhteydenotot pyydämme lähettämään osoitteeseen tmt-rajapinnat@keha-keskus.fi. 

Updated: