Työpaikkailmoitusten rajapinnat

Uudistetun työpaikkailmoituksen julkaisun tavoiteaikataulu on 24.03.2026. Muutoksella on vaikutuksia myös työpaikkailmoituksien rajapintoihin. Rajapinnat uudistuvat siten, että uudet rajapinnat ovat käytössä huhtikuusta 2026 lähtien. Tämän jälkeen kaikki uudet rajapinta-avaukset tehdään uusien rajapintojen ehdoilla ja vaatimuksilla.

Työpaikkailmoituksien vanhat rajapinnat poistuvat käytöstä toukokuussa 2027.  Suosittelemme, että myös vanhojen rajapintojen käyttäjät ottavat työpaikkailmoituksien uudet rajapinnat käyttöön hyvissä ajoin ennen vanhojen rajapintojen sulkeutumista. Uusien rajapintojen käyttöönottoprosessi on samanlainen uusille ja vanhoille käyttäjille. Rajapinnan käyttöönotto vaatii käyttöönottoilmoituksen ja käyttöehtojen hyväksymisen.

Tuontirajapintaa kutsutaan jatkossa hallintarajapinnaksi ja noutorajapintaa hakurajapinnaksi.

Työmarkkinatori-palvelualustalla on kaksi työpaikkailmoituksiin liittyvää ohjelmallista rajapintaa (API), joiden kautta Työmarkkinatorin ulkopuoliset toimijat voivat

• luoda ja hallinnoida omia työpaikkailmoituksiaan Työmarkkinatorilla = hallintarajapinta ja
• hakea työpaikkailmoituksia omiin verkkopalveluihinsa = hakurajapinta.

Kummankin rajapinnan käyttöoikeus on sidottu rajapinnan käyttäjän Y-tunnukseen. Hallintarajapinnan käyttäjän ei tarvitse olla työpaikan varsinainen ilmoittaja, vaan se voi yhtä hyvin olla rekrytoivan organisaation työpaikkailmoitusten julkaisuja hoitava rekrytointi- tai it-palveluyritys.

Rajapintojen käyttöönoton vaiheet

1. Kumman tahansa rajapinnan käyttöönsä ottava organisaatio toimittaa tarvittavat tiedot KEHA-keskukselle käyttöönottoilmoitus-lomakkeella. Samalla lomakkeella sitoudutaan myös näiden käyttöehtojen noudattamiseen.
2. KEHA-keskus tarkistaa organisaation oikeuden ja soveltuvuuden rajapinnan käyttöön.
3. Tarkistuksen jälkeen KEHA-keskus toimittaa käyttäjätunnukset ko. organisaatiolle.
4. Rajapintojen käyttöönotto on kaksivaiheinen. Ensimmäisessä vaiheessa KEHA-keskus toimittaa tunnukset aina Työmarkkinatorin testiympäristöön ja tekee tarvittavat yhteysavaukset sinne.  Toinen vaihe koskee tuotantoympäristön käyttöönottoa:

Hakurajapinta: Kun käyttäjä on testannut rajapinnan ja on valmis siirtymään tuotantoon, hän ilmoittaa siitä KEHA-keskukselle. KEHA-keskus toimittaa sen jälkeen tunnukset tuotantokäyttöä varten.

Hallintarajapinta: Kun käyttäjä on testannut rajapinnan ja on valmis siirtymään tuotantoon, hänen tulee ilmoittaa siitä KEHA-keskukselle ja lähettää vielä KEHA-keskuksen antamat testitapaukset hallintarajapinnan kautta. KEHA-keskus varmistaa testauksen laadun ja toimittaa sen jälkeen tunnukset tuotantokäyttöä varten.

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