Beskrivning av hämtgränssnittet och anvisningar

På serviceplattformen Jobbmarknaden finns ett programmeringsgränssnitt (API) för jobbsökarprofiler. Via gränssnittet kan användaren hämta uppgifter om arbetserfarenhet och kompetens på Jobbmarknaden och använda de som en del av en profil i en annan tjänst. Gränssnittet ger en teknisk möjlighet att hämta uppgifterna. 

Rätten att använda gränssnittet är bunden till organisationens FO-nummer. För att uppgifter ska kunna hämtas från serviceplattformen Jobbmarknaden till andra tjänster krävs användarens tillstånd. 

Uppgifterna i jobbsökarprofilen överförs vid ett och samma tillfälle från serviceplattformen Jobbmarknaden via hämtgränssnittet till den tjänst som tillhandahålls av den organisation som hämtar uppgifterna. Uppgifterna i jobbsökningsprofilen kan också hämtas i flera omgångar, men användaren måste då ge ett separat tillstånd för varje hämtning. Uppgifterna i jobbsökarprofilen hämtas till den externa tjänsten i det format som anges i gränssnittsbeskrivningen.  

Från Jobbmarknaden hämtas endast de uppgifter som användaren har gett tillstånd att överföra. Inga andra uppgifter hämtas. När uppgifterna i jobbsökarprofilen har hämtats från Jobbmarknaden ska de hanteras i den externa tjänsten. Uppgifterna i jobbsökarprofilen kan därefter fortfarande uppdateras på Jobbmarknaden, men de uppdaterade uppgifterna synkroniseras inte automatiskt med den tjänst som profiluppgifterna tidigare har hämtats till.   

Steg för att ta i bruk hämtgränssnittet 

1. En organisation som är intresserad av gränssnittet tar del av beskrivningen av Jobbmarknadens hämtgränssnitt för jobbsökarprofiler, användarvillkoren och de tekniska anvisningarna. 
2. Den organisation som tar i bruk gränssnittet skickar de uppgifter som behövs till UF-centret med blanketten för anmälan om ibruktagande. På samma blankett förbinder man sig också att följa användarvillkoren. 
3. UF-centret kontrollerar organisationens rätt och lämplighet att använda gränssnittet. 
4. Efter kontrollen skickar UF-centret användarkoderna till den organisation som ska ta i bruk gränssnittet. 
5. Gränssnittet tas i bruk i två faser. I den första fasen skickar UF-centret alltid användarkoderna till Jobbmarknadens testmiljö och öppnar nödvändiga anslutningar dit. Innan produktionsmiljön öppnas ska gränssnittet alltid samtestas tillsammans med UF-centret.  
6. När organisationen som tar i bruk gränssnittet har testat att gränssnittet fungerar tillsammans med UF-centret, kan användarkoder till importgränssnittets produktionsmiljö skickas till organisationen.