Tjänstegränssnitt API Vägledning

Relevanta dokument
Tjänstegränssnitt Api Platsannons

Tjänstegränssnitt Api Platsannons

Jobbmöjligheter på den svenska arbetsmarknaden

Arbetsmarknad Prognos för arbetsmarknaden 2015

Besökarens profil och upplevelse

Företagens framtida rekryteringsbehov i Öresundsregionen

Laboration 2 RESTful webb-api

Vuxenutbildning 2017 sfi och sfx Länet totalt

Arbetsförmedlingen Navet på arbetsmarknaden

Introduktion till integrering av Schenkers e-tjänster. Version 2.0

1. Innehållsförteckning till detta häfte 2. Pärm Försättsblad till pärm Innehåll. 3. Lärarhandledning Utdrag ur Lpo 94 4.

FAKTABLAD GOTLAND Statistik gällande utbildning, kompetensförsörjning och arbetsmarknad

Arbetsmarknadsprognos för vanligaste yrken i Västra Götaland

SEMA OREN 1.0. Ett utvecklingsprojekt finansierat av Region Gävleborg och Tillväxtverket. 1 febr nov. 2017

Leverans-API för nedladdning av geodata v1.0 - teknisk beskrivning

Introduktion Schenker-BTL AB, Stab IT Beskrivning över informationsintegreringmed Schenker, metodbeskrivning version 1.

FAKTABLAD GOTLAND Statistik gällande utbildning, kompetensförsörjning och arbetsmarknad

KARTLÄGGNING AV KOMMUNALA YRKESUTBILDNINGAR FÖR VUXNA OCH YRKESHÖGSKOLAN

KARTLÄGGNING AV KOMMUNALA YRKESUTBILDNINGAR FÖR VUXNA OCH YRKESHÖGSKOLAN

TJÄNSTEBESKRIVNING FASAD Tjänstebaserad direktåtkomst Byggnad

KARTLÄGGNING AV KOMMUNALA YRKESUTBILDNINGAR FÖR VUXNA OCH YRKESHÖGSKOLAN

Jobbmöjligheter. I Västmanlands län Marcus Löwing Analysavdelningen

JavaScript in SharePoint and not just for Apps. Wictor Wilén

InTime HTTP API. Översikt funktioner. Webbtjänster för systemintegration med InTime Messenger.

Utkast/Version (8) Användarhandledning - inrapportering maskin-till-maskin

Webbteknik II. Föreläsning 5. Restless farewell. John Häggerud, 2011

Webbtjänster med API er

Vuxenutbildning 2018 sfiochsfx Haninge

Stenungsund. Tjörn Undervisning skolverket

Arbetsmarknad för unga med funktionsnedsättning. Bengt Eklund Avdelningen Rehabilitering Strategienheten Arbetsförmedlingen

Bemanningsföretagen - omsättning

AKU:s yrkesredovisning övergår till SSYK 2012 från SSYK 96

API Notera HTTPS POST msg UTF-8. API_key JSON Mobilnummer format 1. Skicka ett SMS till specifikt nummer POST parametrar: from msg API_key Exempel:

KARTLÄGGNING AV KOMMUNALA YRKESUTBILDNINGAR FÖR VUXNA OCH YRKESHÖGSKOLAN

Utbildningar inom yrkeshögskolan. Utbildningsplatser som avslutas

TJÄNSTEBESKRIVNING FASAD Tjänstebaserad direktåtkomst Adress

Swedbank Mobile Loadtesting. LoadRunner Mobile App protocol

Vitec Connect. Teknisk beskrivning REVIDERAT SENAST: VITEC. VITEC Affärsområde Mäklare

KARTLÄGGNING AV KOMMUNALA YRKESUTBILDNINGAR FÖR VUXNA OCH YRKESHÖGSKOLAN

Utbildningar. inom yrkeshögskolan. Utbildningsplatser som avslutas

Fass webbtjänster Veterinära Fass-texter

Utbildningar inom yrkeshögskolan. Utbildningsplatser som avslutas

Geografisk Indelning Direkt v teknisk beskrivning

1ME323 Webbteknik 3 Lektion 6 API. Rune Körnefors. Medieteknik Rune Körnefors

LEFI Online, system till system (Leverera Förmånsinformation) WEBBSERVICE/SHS/SSEK

Webbteknik II. Föreläsning 4. Watching the river flow. John Häggerud, 2011

XML-produkter. -Registret över verkliga huvudmän (RVH) Teknisk handledning för webbtjänst mot RVH (Web Services) Datum: Version: 1.

Utbildningar inom yrkeshögskolan Utbildningsplatser som avslutas

Jobbmöjligheter i Jämtlands län. Christina Storm-Wiklander Marknadsområde Södra Norrland Maria Salomonsson Analysavdelningen

ANSÖKAN OM PENSIONSFÖRSÄKRING UTAN ÅTERBETALNINGSSKYDD

KARTLÄGGNING AV KOMMUNALA YRKESUTBILDNINGAR FÖR VUXNA OCH YRKESHÖGSKOLAN

Invandrarindex november Utdrag ur rapport

YH - antal platser med avslut

Fass webbtjänster Veterinära bipacksedlar

Var finns jobben? Bedömning för 2016 och en långsiktig utblick

Objektorienterad programmering i Java I. Uppgifter: 2 Beräknad tid: 5-8 timmar (OBS! Endast ett labbtillfälle) Att läsa: kapitel 5 6

Fass webbtjänster Bipacksedlar

Registerbeteckning Direkt v teknisk beskrivning

Services + REST och OAuth

API:er/Mashup. Föreläsning 4 API:er och Mashups. Johan Leitet johan.leitet@lnu.se twitter.com/leitet facebook.com/leitet. Webbteknik II, 1DV449

Personlig hjälp till nytt arbete - för tjänstemän!

Vuxenutbildning 2018 sfi och sfx Nacka

Myndigheten för yrkeshögskolans omvärldsbevakning och analysarbete. yhmyndigheten.se

FAKTABLAD GOTLAND Statistik gällande utbildning, kompetensförsörjning och arbetsmarknad

Arbetsmarknad i förändring

Utbildningar inom yrkeshögskolan Utbildningsplatser som avslutas Rapport 2016

REST API Generellt https POST UTF-8 API_key JSON

Utfall ansökningsomgång 2018

PHP - Fortsättning. PHP och MySQL

Vuxenutbildning 2015 sfi och sfx Nacka

E-legitimationsnämndens legitimeringstjänster för test

Uppgiftskravstjänsten Teknisk anslutning för att hämta uppgiftskrav som öppna data. Version 1.0

Jobbmöjligheter i Jämtlands län. Maria Salomonsson Analysavdelningen

Axiell Arena Visa BOOK-IT:s resurser

Webbtjänster med API er

Referens Uppslag Adress v teknisk beskrivning

Vuxenutbildning 2017 sfi och sfx Stockholms Intensivsvenska för akademiker SFI

Webbtjänster med API er

Filleveranser till VINN och KRITA

Vuxenutbildning 2016 sfi och sfx Sollentuna

Branschstandarden BEAst Document Överföring av handlingar

Tudelad arbetsmarknad

Faktura/Saldobesked Gränssnittsdokumentation. Version 5.1

Det här dokumentet är till för att ge en översikt över ASP.NET MVC samt hur WCF Services används från.net applikationer.

Presentation Seniorpanelen 2017 AMF

Arbetsmarknadsutsikterna hösten 2016 Prognos för arbetsmarknaden 2017

Fass webbtjänster Fass Vet.- texter

En sammanfattning av Arbetsmarknadsutsikterna hösten 2016 Norrbottens län

RDT Externt Webbtjänst Gränssnitt

Kvinnor och mäns Företagande

Figur 1: Drömjobb bland alla respondenter (anställda, studerande, arbetssökande och egenföretagare) 2011, 2009 och 2006

Arbetsmarknadsbarometern Richard Palmer, ÅSUB

Ajax TruClient. Erfarenheter, tips och trix från Swedbank IT. Christian Gerdes Performance Engineer, LIGHTS IN LINE AB

Karusell med länkade omslagsbilder

Digital inlämning av årsredovisningar

Arbetshypoteser för Elmarknadshubbens API - april Version 1.0

E-pliktleverans via RSS-feeds

Fass webbtjänster Veterinära bipacksedlar

Webservice tjänsten GetPerson Slagning mot befolkningsregister

Dokumentation för tjänsten Tjänstefördelning

Transkript:

Sida: 1 av 23 2017-06-21 Tjänstegränssnitt API Vägledning Tjänstegränssnitt API Vägledning Version 1.3 Gränssnittsbeskrivning

Sida: 2 av 23 Revisionshistoria Datum Version Beskrivning Författare 2016-06-16 0.1 Upprättande av Jimmy Widlund dokumentet 2016-07-08 1.0 Färdigställande av Johanna Nilsson dokument 2017-06-09 1.0 Rättat felaktig URL Ulrika Häggqvist kombination 2017-06-20 1.3 Rättat felaktig URL Mats Löfstrand

Sida: 3 av 23 Innehållsförteckning 1 INLEDNING... 4 1.1 SYFTE... 4 1.2 VILLKOR... 4 2 ÖVERSIKT... 4 2.1 ALLMÄNT... 4 2.2 PROGNOSYRKEN ENLIGT SSYK - NULÄGE OCH KOMMANDE FÖRÄNDRINGAR... 5 2.3 TEKNIK... 5 2.4 HTTP-ADRESS... 6 3 METODER... 6 3.1 VERSION... 7 3.2 SÖKLISTOR... 7 3.2.1 Soklista-Request... 8 3.2.2 Soklista-Response... 9 3.3 NYCKELORD... 11 3.3.1 Nyckelord-Request... 11 3.3.2 Nyckelord-Respons... 11 3.4 PROGNOSID... 17 3.4.1 PrognosID - Request... 17 3.4.2 PrognosID-Respons... 17 4 FELHANTERING... 23 4.1 STATUSKODER... 23 4.2 FEL-RESPONSE... 23

Sida: 4 av 23 1 Inledning 1.1 Syfte Syftet med detta dokument är att ge utvecklare information om hur de ska anropa och nyttja Arbetsförmedlingens API Vägledning. 1.2 Villkor Se dokumentet Användarvillkor. 2 Översikt 2.1 Allmänt Långsiktiga prognoser på fem och tio års sikt är framtagna i februari 2016. Dessa har tagits fram genom analyser och beräkningar av det prognostiserade utbudet av arbetskraft i olika yrken. Hänsyn har tagits till bland annat pensionsavgångar, utbildningsvolymer, yrkesrörlighet och migration. Till detta har sedan en bedömning av den långsiktiga utvecklingen på arbetsmarknaden och efterfrågan på arbetskraft inom olika yrken lagts. De långsiktiga prognoserna avgränsas till de yrken där Arbetsförmedlingen bedömer att det statistiska underlaget är tillräckligt stort för att möjliggöra de beräkningar som är nödvändiga. Läs mer om arbetsförmedlingens prognosarbete http://www.arbetsformedlingen.se/om-oss/statistik-prognoser/prognoser.html Arbetsförmedlingen har gjort yrkesprognoser på fem och tio års sikt i enighet med SSYK96. De långsiktiga prognoserna kommer preliminärt att presenteras enligt SSYK 2012 för första gången i februari 2018. Detta betyder att vi inte gör några långsiktiga prognoser i februari 2017. Under 2017 kommer de långsiktiga prognoserna som gjordes i januari 2016 finnas tillgängliga via Arbetsförmedlingens öppna API. Då de långsiktiga prognoserna görs enligt en äldre version av SSYK är det inte möjligt att jämföra de kortsiktiga prognoserna med de långsiktiga prognoserna eftersom dessa versioner innehåller helt olika uppsättningar yrken. Med API Vägledning är det möjligt att integrera Arbetsförmedlingens långsiktiga prognoser i egenbyggda applikationer. I dagsläget kan du genom APIet hämta ut de långsiktiga yrkesprognoserna i XML och JSON-format, medan de kortsiktiga prognoserna finns att hämta i CSV-format på www.arbetsformedlingen.se/psidata.

Sida: 5 av 23 API Vägledning är ett öppet gränssnitt utan krav på registrering. Genom att använda APIet godkänner du användarvillkoren. 2.2 Prognosyrken enligt SSYK - nuläge och kommande förändringar Prognosbedömningar på kort sikt görs för yrken enligt svensk standard för yrkesklassificering version 2012. Prognosbedömningar på lång sikt har gjorts (senast publicerat februari 2016) för yrken enligt svensk standard för yrkesklassificering version 96. Läs mer om SSYK på SCBs hemsida http://www.scb.se/sv_/dokumentation/klassifikationer-och-standarder/standardfor-svensk-yrkesklassificering-ssyk/ Från och med februari 2017 kommer de kortsiktiga prognoserna att göras enligt Svensk Standard för Yrkesklassificering version 2012. Detta innebär en helt ny uppsättning yrken. I och med att detta är olika versioner är det inte möjligt att jämföra prognoser mellan versionerna. De långsiktiga prognoserna kommer preliminärt att presenteras enligt SSYK 2012 för första gången i februari 2018. Detta betyder att vi inte gör några långsiktiga prognoser i februari 2017. Under 2017 kommer de långsiktiga prognoserna som gjordes i februari 2016 finnas tillgängliga. 2.3 Teknik API:et är en RESTful webbtjänst (REpresentational State Transfer), vilket betyder att den använder sig av http protokollet för att ta emot och returnera data. För att kommunicera med API:et används http-metoder. http-metod GET Beskrivning Get operation innebär att hämta den information som identifierats av Request-uri. Tabell 1 http-metoder Data som returneras från tjänsten är av typerna JSON, XML och version returneras som TEXT. Vilket format som returneras bestämmer det anropande klienten i http accept-headern då API Vägledning anropas. Om inte format anges i accept-headern så returneras default JSON. Request-header Beskrivning

Sida: 6 av 23 Accept Önskat dataformat i svaret/response (Content-type) Exempel: Accept: application/json Tabell 2 http-headers Anrop till tjänsten sker via URI. Utseendet på URI:n är följande: http://[url]/yrkesprognoser /{metod}?{parametrar} http://[url]/yrkesprognoser/{subresurs}/{metod}?{parametrar} Term [Url] Yrkesprognoser {Subresurs} {Metod} {Parametrar} Beskrivning Url är http-adressen till tjänsten. Resursen är en indelning av metoder som hör ihop. Undergruppering inom en resurs. Metod är den operation som efterfrågas och som utför önskad uppgift. Parametrar är query-parametrar som används av metod för att filtrera eller utföra sin uppgift. Tabell 3 url förklaring 2.4 Http-Adress Adressen till API:et är följande: http://api.arbetsformedlingen.se/af/v0 I resten av dokumentet kommer denna http-adressen att symboliseras av [url]. 3 Metoder Metoderna i API:et har till uppgift att visa yrkesprognoser. Utöver att hitta yrkesprognoser så finns även söklistor (yrkesområden och prognosid) vars uppgift är att användas som underlag (sökkriterier) för att visa upp prognosdata. De metoder och resurser som tjänsten tillhandahåller är:

Sida: 7 av 23 [url]/yrkesprognoser/version [url]/yrkesprognoser/soklista/prognoser [url]/yrkesprognoser/soklista/prognoser?yrkesomradeid={*} [url]/yrkesprognoser/prognoser?nyckelord={*} [url]/yrkesprognoser/prognos?prognosid={*} {*} = Obligatorisk parameter/värde {M} = Minst en av parametrarna ska finnas {V} = Valfri parameter (ej obligatorisk) I följande kapitel beskrivs varje metod mer ingående. 3.1 Version Anrop som kan användas för att se aktuell version för API:et: [url]/yrkesprognoser/version 3.2 Söklistor Söklistorna har i uppgift att returnera listor av olika slag. Syftet med listorna är att lista alla IDn för att kunna hämta en prognos i sin helhet. Det finns två söklistor. Den ena listar alla prognoser och dess IDn. Den andra listar alla prognoser för yrken inom ett visst yrkesområde. I varje rad i resultatlistan prognoser finns: <PrognosID></PrognosID> <Prognosrubrik></Prognosrubrik> <YrkesgruppID></YrkesgruppID> <UndergruppID></UndergruppID> <YrkesbenamningID></YrkesbenamningID> YrkesomradeID finns att nå på tre olika sätt: YrkesomradeID finns också listade i fil på www.arbetsformedlingen.se/psidata som innehåller Arbetsförmedlingens kortsiktiga prognoser. Via Arbetsförmedlinges öppna API för Platsannonser http://api.arbetsformedlingen.se/platsannons/soklista/yrkesomraden De finns också listade i tabellen nedan: Administration, ekonomi, juridik 1

Sida: 8 av 23 Bygg och anläggning 2 Data/IT 3 Försäljning, inköp, marknadsföring 5 Hantverksyrken 6 Hotell, restaurang, storhushåll 7 Hälso- och sjukvård 8 Industriell tillverkning 9 Installation, drift, underhåll 10 Kropps- och skönhetsvård 4 Kultur, media, design 11 Militärt arbete 22 Naturbruk 13 Naturvetenskapligt arbete 14 Pedagogiskt arbete 15 Sanering och renhållning 12 Socialt arbete 16 Säkerhetsarbete 17 Tekniskt arbete 18 Transport 19 3.2.1 Soklista-Request URL: Godkända URL-kombinationer för att erhålla en söklista: Söklista prognoser inom ett yrkesområden: - [url]/yrkesprognoser/soklista/prognoser?yrkesomradeid={*} Söklista prognoser, samtliga: - [url]/yrkesprognoser/soklista/prognoser {*} = Obligatorisk parameter/värde {M} = Minst en av parametrarna ska finnas {V} = Valfri parameter (ej obligatorisk) Returformat (Content-type): JSON XML

Sida: 9 av 23 HTTP-metod: GET Queryparametrar: Namn Typ Beskrivning Yrkesomradeid Int unikt ID för yrkesområde. Tabell 4 Queryparametrar till soklista Exempel: Hämta en lista med alla prognoser http://[url]/yrkesprognoser/soklista/prognoser Hämta en söklista med prognoser per yrkesområdeid Säkerhetsarbete : [url]/yrkesprognoser/soklista/prognoser?yrkesomradeid=17 3.2.2 Soklista-Response Retursvar: Namn Typ Förekomst Beskrivning collection [1..1] Rotnod som wrappar in listan. Prognos Array [1..n] Lista med prognosinfo. PrognosID Int [1..1] Id för en prognos. T ex 3874. Detta är ett unikt ID för den aktuella prognosen. Notera att detta ID inte är unikt för prognosyrket och uppdateras när prognosen eller dess beskrivning uppdateras. Prognosrubrik String [1..1] Namnet på prognosen. T ex Elmontörer. YrkesgruppID Int [1..1] Unikt ID för yrkesgrupp enligt SSYK. T ex 724. UndergruppID Int [0..1] Unikt ID för yrkesundergrupp enligt SSYK. Motsvarar Yrkesgrupper enligt Arbetsförmedlingens taxonomi. T ex 7214

Sida: 10 av 23 YrkesbenamningID String [0..1] ID för yrkesbenämning enligt Arbetsförmedlingens taxonomi. Tabell 5 Retursvar soklista JSON Tex 6412 [ { "undergruppid": "9150", "yrkesgruppid": "915", "prognosid": "4737", "prognosrubrik": "Renhållnings- och återvinningsarbetare", "yrkesbenamningid": "" }, { "undergruppid": "9122", "yrkesgruppid": "912", "prognosid": "4738", "prognosrubrik": "Städare", "yrkesbenamningid": "" } ] XML <collection> <Prognos> <PrognosID>4571</PrognosID> <Prognosrubrik>Jurister</Prognosrubrik> <YrkesgruppID>242</YrkesgruppID> <UndergruppID/> <YrkesbenamningID/> </Prognos> <Prognos> <PrognosID>4572</PrognosID> <Prognosrubrik>Revisorer</Prognosrubrik> <YrkesgruppID>241</YrkesgruppID> <UndergruppID>2411</UndergruppID> <YrkesbenamningID>5670</YrkesbenamningID> </Prognos> </collection>

Sida: 11 av 23 3.3 Nyckelord Returnerar komplett prognosinformation för sökt nyckelord. 3.3.1 Nyckelord-Request URL: Anrop för att hämta prognoser med hjälp av en nyckelordssökning: [url]/yrkesprognoser/prognoser?nyckelord={*} {*} = Obligatorisk parameter/värde {M} = Minst en av parametrarna ska finnas {V} = Valfri parameter (ej obligatorisk) Returformat (Content-type): JSON XML HTTP-metod: GET Queryparametrar: Namn Typ Beskrivning Nyckelord String Valfritt sökord Tabell 6 Queryparametrar till prognos Exempel: Hämta prognos med nyckelordet Polis: [url]/yrkesprognoser/prognoser?nyckelord=polis 3.3.2 Nyckelord-Respons Retursvar: Namn Typ Förekomst Beskrivning

Sida: 12 av 23 collection [1..1] Rotnod som wrappar in listan. Prognos [1..n] Nod som grupperar information om yrkesprognoser. PrognosID Int [1..1] Unikt ID för den aktuella prognosen. Detta ID är inte unikt för prognosyrket och uppdateras när nya prognoser görs. Prognosrubrik String [1..1] Titeltext. Yrkesomrade String [1..1] Yrkesområde som prognosen tillhör YrkesomradeID Int [1..1] Unikt id för yrkesområdet Yrkesgrupp String [1..1] Namnet på yrkesgruppen Yrkesgruppid Int [1..1] Unikt ID för yrkesgrupp enligt SSYK. Undergrupp String [0..1] Namn på yrkets undergrupp UndergruppID Int [0..1] Unikt ID för Undergrupp enligt SSYK. Motsvarar Yrkesgrupper enligt Arbetsförmedlingens taxonomi Yrkesbenamning String [0..1] Namn på yrkesbenämning YrkesbenamningID Int [0..1] ID för yrkesbenämning enligt Arbetsförmedlingens taxonomi. Publiceringsdatum Datetime [1..1] Datum då någon information i prognosen uppdaterats. Långsiktiga prognoser (5 och 10 år) uppdateras i januari varje år med undantag från januari 2017 då arbetsförmedlingen inte

Sida: 13 av 23 kommer att publicera nya långsiktiga prognoser. Under 2017 kommer de långsiktiga prognoserna som gjordes i januari 2016 finnas kvar. De kortsiktiga prognoserna (1 år) uppdateras i januari och juni varje år. I samband med detta uppdateras prognosbeskrivningen och publiceringsdatum. Status String [1..1] Barometer10Ar Int [1..1] Bedömningarna uttrycks med hjälp av en siffra 0-5 där: 0. saknar prognos 1. mycket hård konkurrens om jobben 2. hård konkurrens om jobben 3. balans 4. liten konkurrens om jobben 5. mycket liten konkurrens om jobben Barometer5Ar Int [1..1] Bedömningarna med hjälp av en siffra 0-5 där: 0. saknar prognos 1. mycket hård konkurrens om jobben 2. hård konkurrens om jobben 3. balans 4. liten konkurrens om jobben 5. mycket liten konkurrens om jobben

Sida: 14 av 23 PrognosbeskrivningHTML String [1..1] Prognosbeskrivning i htmlformat. Prognosbeskrivning String [1..1] Ej formaterad prognosbeskrivning. Tabell 7 Retursvar Nyckelord JSON [ { "publiceringsdatum": "2016-06-29 00:00:00", "prognosid": "4740", "rubrik": "Poliser", "status": "Publicerad", "undergrupp": "Poliser", "undergruppid": "3450", "yrkesgrupp": "Poliser", "yrkesgruppid": "345", "yrkesomrade": "Säkerhetsarbete", "yrkesomradeid": "17", "barometer10ar": 4, "barometer5ar": 4, "yrkesbenamning": "", "yrkesbenamningid": "", "prognosbeskrivninghtml": "<p><strong>arbetsförmedlingen bedömer att poliser har goda möjligheter till arbete under det närmaste året. Antalet poliser i samhället bestäms av politiska beslut. Även på fem och tio års sikt väntas möjligheterna till arbete bli goda.<br /><br /></strong><strong><font size=\"3\">prognos på ett års sikt <br /></font></strong>det finns cirka 20 000 yrkesverksamma poliser i Sverige, enligt Polismyndigheten.<br /><br /><strong>efterfrågan</strong> på poliser väntas öka det närmaste året i takt med att befolkningen ökar. Hur många poliser som finns i samhället bestäms av regeringen. Antalet utbildningsplatser är därmed anpassade efter förväntat behov och resurser. Söktrycket på polisutbildningen är högt, vilket innebär att det är stor konkurrerens om utbildningsplatserna. Den som klarar utbildningen och aspiranttiden har inga svårigheter att få anställning som polis. Det innebär att det i praktiken inte finns någon arbetslöshet bland poliser.<br /><br /><strong><font size=\"3\">prognos på fem och tio års

Sida: 15 av 23 sikt <br /></font></strong>arbetsförmedlingen bedömer att arbetsmarknaden för poliser blir god både på fem och tio års sikt.<br /><br /><strong>efterfrågan</strong> på poliser väntas öka något de närmaste tio åren. Antalet poliser i samhället bestäms av politiska beslut. Förändringar i samhället kan påverka behovet av antalet poliser ytterligare.<br /><br /><strong>tillgången</strong> på poliser väntas möta efterfrågan eftersom antalet utbildningsplatser anpassas till förväntat behov.</p>", "prognosbeskrivning": "Arbetsförmedlingen bedömer att poliser har goda möjligheter till arbete under det närmaste året. Antalet poliser i samhället bestäms av politiska beslut. Även på fem och tio års sikt väntas möjligheterna till arbete bli goda.\n\nprognos på ett års sikt \ndet finns cirka 20 000 yrkesverksamma poliser i Sverige, enligt Polismyndigheten.\n\nEfterfrågan på poliser väntas öka det närmaste året i takt med att befolkningen ökar. Hur många poliser som finns i samhället bestäms av regeringen. Antalet utbildningsplatser är därmed anpassade efter förväntat behov och resurser. Söktrycket på polisutbildningen är högt, vilket innebär att det är stor konkurrerens om utbildningsplatserna. Den som klarar utbildningen och aspiranttiden har inga svårigheter att få anställning som polis. Det innebär att det i praktiken inte finns någon arbetslöshet bland poliser.\n\nprognos på fem och tio års sikt \narbetsförmedlingen bedömer att arbetsmarknaden för poliser blir god både på fem och tio års sikt.\n\nefterfrågan på poliser väntas öka något de närmaste tio åren. Antalet poliser i samhället bestäms av politiska beslut. Förändringar i samhället kan påverka behovet av antalet poliser ytterligare.\n\ntillgången på poliser väntas möta efterfrågan eftersom antalet utbildningsplatser anpassas till förväntat behov." } ] XML <collection> <Prognos> <PrognosID>4740</PrognosID> <Prognosrubrik>Poliser</Prognosrubrik> <Yrkesomrade>Säkerhetsarbete</Yrkesomrade> <YrkesomradeID>17</YrkesomradeID> <Yrkesgrupp>Poliser</Yrkesgrupp> <YrkesgruppID>345</YrkesgruppID> <Undergrupp>Poliser</Undergrupp> <UndergruppID>3450</UndergruppID> <Yrkesbenamning/> <YrkesbenamningID/> <Publiceringsdatum>2016-06-29 00:00:00</Publiceringsdatum>

Sida: 16 av 23 <Status>Publicerad</Status> <Barometer10Ar>4</Barometer10Ar> <Barometer5Ar>4</Barometer5Ar> <PrognosbeskrivningHTML> <p><strong>arbetsförmedlingen bedömer att poliser har goda möjligheter till arbete under det närmaste året. Antalet poliser i samhället bestäms av politiska beslut. Även på fem och tio års sikt väntas möjligheterna till arbete bli goda.<br /><br /></strong><strong><font size="3">prognos på ett års sikt <br /></font></strong>det finns cirka 20 000 yrkesverksamma poliser i Sverige, enligt Polismyndigheten.<br /><br /><strong>efterfrågan</strong> på poliser väntas öka det närmaste året i takt med att befolkningen ökar. Hur många poliser som finns i samhället bestäms av regeringen. Antalet utbildningsplatser är därmed anpassade efter förväntat behov och resurser. Söktrycket på polisutbildningen är högt, vilket innebär att det är stor konkurrerens om utbildningsplatserna. Den som klarar utbildningen och aspiranttiden har inga svårigheter att få anställning som polis. Det innebär att det i praktiken inte finns någon arbetslöshet bland poliser.<br /><br /><strong><font size="3">prognos på fem och tio års sikt <br /></font></strong>arbetsförmedlingen bedömer att arbetsmarknaden för poliser blir god både på fem och tio års sikt.<br /><br /><strong>efterfrågan</strong> på poliser väntas öka något de närmaste tio åren. Antalet poliser i samhället bestäms av politiska beslut. Förändringar i samhället kan påverka behovet av antalet poliser ytterligare.<br /><br /><strong>tillgången</strong> på poliser väntas möta efterfrågan eftersom antalet utbildningsplatser anpassas till förväntat behov.</p> </PrognosbeskrivningHTML> <Prognosbeskrivning> Arbetsförmedlingen bedömer att poliser har goda möjligheter till arbete under det närmaste året. Antalet poliser i samhället bestäms av politiska beslut. Även på fem och tio års sikt väntas möjligheterna till arbete bli goda. Prognos på ett års sikt Det finns cirka 20 000 yrkesverksamma poliser i Sverige, enligt Polismyndigheten. Efterfrågan på poliser väntas öka det närmaste året i takt med att befolkningen ökar. Hur många poliser som finns i samhället bestäms av regeringen. Antalet utbildningsplatser är därmed anpassade efter förväntat behov och resurser. Söktrycket på polisutbildningen är högt, vilket innebär att det är stor konkurrerens om utbildningsplatserna. Den som klarar utbildningen och aspiranttiden har inga svårigheter att få anställning som polis. Det innebär att det i praktiken inte finns någon arbetslöshet bland poliser. Prognos på fem och tio års sikt Arbetsförmedlingen bedömer att arbetsmarknaden för poliser blir

Sida: 17 av 23 god både på fem och tio års sikt. Efterfrågan på poliser väntas öka något de närmaste tio åren. Antalet poliser i samhället bestäms av politiska beslut. Förändringar i samhället kan påverka behovet av antalet poliser ytterligare. Tillgången på poliser väntas möta efterfrågan eftersom antalet utbildningsplatser anpassas till förväntat behov. </Prognosbeskrivning> </Prognos> </collection> 3.4 PrognosID Returnerar komplett prognosinformation för angivet prognosid. 3.4.1 PrognosID - Request URL: Anrop för att hämta prognos med hjälp av PrognosID: [url]/yrkesprognoser/prognos?prognosid={*} {*} = Obligatorisk parameter/värde {M} = Minst en av parametrarna ska finnas {V} = Valfri parameter (ej obligatorisk) Returformat (Content-type): JSON XML HTTP-metod: GET Queryparametrar: Namn Typ Beskrivning PrognosID Int Unikt ID för den aktuella prognosen. Detta ID är inte unikt för prognosyrket och uppdateras när nya prognoser görs. Tabell 8 Queryparametrar till PrognosID Exempel: Hämta prognos med ID 4605 (bagare/konditorer): [url]/yrkesprognoser/prognos?prognosid=4605 3.4.2 PrognosID-Respons Retursvar:

Sida: 18 av 23 Namn Typ Förekomst Beskrivning collection [1..1] Rotnod som wrappar in listan. Prognos [1..n] Nod som grupperar information om yrkesprognoser. PrognosID Int [1..1] Unikt ID för den aktuella prognosen. Detta ID är inte unikt för prognosyrket och uppdateras när nya prognoser görs. Prognosrubrik String [1..1] Titeltext. Yrkesomrade String [1..1] Yrkesområde som prognosen tillhör YrkesomradeID Int [1..1] Unikt id för yrkesområdet Yrkesgrupp String [1..1] Namnet på yrkesgruppen Yrkesgruppid Int [1..1] Unikt ID för yrkesgrupp enligt SSYK. Undergrupp String [0..1] Namn på yrkets undergrupp UndergruppID Int [0..1] Unikt ID för Undergrupp enligt SSYK. Motsvarar Yrkesgrupper enligt Arbetsförmedlingens taxonomi Yrkesbenamning String [0..1] Namn på yrkesbenämning YrkesbenamningID Int [0..1] ID för yrkesbenämning enligt Arbetsförmedlingens taxonomi. Publiceringsdatum Datetime [1..1] Datum då någon information i prognosen uppdaterats. Långsiktiga prognoser (5 och 10 år) uppdateras i januari varje år med undantag från januari

Sida: 19 av 23 2017 då arbetsförmedlingen inte kommer att publicera nya långsiktiga prognoser. Under 2017 kommer de långsiktiga prognoserna som gjordes i januari 2016 finnas kvar. De kortsiktiga prognoserna (1 år) uppdateras i januari och juni varje år. I samband med detta uppdateras prognosbeskrivningen och publiceringsdatum. Status String [1..1] Barometer10Ar Int [1..1] Bedömningarna uttrycks med hjälp av en siffra 0-5 där: 0. saknar prognos 1. mycket hård konkurrens om jobben 2. hård konkurrens om jobben 3. balans 4. liten konkurrens om jobben 5. mycket liten konkurrens om jobben Barometer5Ar Int [1..1] Bedömningarna med hjälp av en siffra 0-5 där: 0. saknar prognos 1. mycket hård konkurrens om jobben 2. hård konkurrens om jobben 3. balans 4. liten konkurrens om jobben

Sida: 20 av 23 5. mycket liten konkurrens om jobben PrognosbeskrivningHTML String [1..1] Prognosbeskrivning i htmlformat. Prognosbeskrivning String [1..1] Ej formaterad prognosbeskrivning. Tabell 9 Retursvar prognosid JSON { "publiceringsdatum": "2016-06-29 00:00:00", "prognosid": "4740", "rubrik": "Poliser", "status": "Publicerad", "undergrupp": "Poliser", "undergruppid": "3450", "yrkesgrupp": "Poliser", "yrkesgruppid": "345", "yrkesomrade": "Säkerhetsarbete", "yrkesomradeid": "17", "barometer10ar": 4, "barometer5ar": 4, "yrkesbenamning": "", "yrkesbenamningid": "", "prognosbeskrivninghtml": "<p><strong>arbetsförmedlingen bedömer att poliser har goda möjligheter till arbete under det närmaste året. Antalet poliser i samhället bestäms av politiska beslut. Även på fem och tio års sikt väntas möjligheterna till arbete bli goda.<br /><br /></strong><strong><font size=\"3\">prognos på ett års sikt <br /></font></strong>det finns cirka 20 000 yrkesverksamma poliser i Sverige, enligt Polismyndigheten.<br /><br /><strong>efterfrågan</strong> på poliser väntas öka det närmaste året i takt med att befolkningen ökar. Hur många poliser som finns i samhället bestäms av regeringen. Antalet utbildningsplatser är därmed anpassade efter förväntat behov och resurser. Söktrycket på polisutbildningen är högt, vilket innebär att det är stor konkurrerens om utbildningsplatserna. Den som klarar utbildningen och aspiranttiden har inga svårigheter att få anställning som polis. Det innebär att det i praktiken inte finns någon arbetslöshet bland poliser.<br /><br /><strong><font size=\"3\">prognos på fem och tio års

Sida: 21 av 23 sikt <br /></font></strong>arbetsförmedlingen bedömer att arbetsmarknaden för poliser blir god både på fem och tio års sikt.<br /><br /><strong>efterfrågan</strong> på poliser väntas öka något de närmaste tio åren. Antalet poliser i samhället bestäms av politiska beslut. Förändringar i samhället kan påverka behovet av antalet poliser ytterligare.<br /><br /><strong>tillgången</strong> på poliser väntas möta efterfrågan eftersom antalet utbildningsplatser anpassas till förväntat behov.</p>", "prognosbeskrivning": "Arbetsförmedlingen bedömer att poliser har goda möjligheter till arbete under det närmaste året. Antalet poliser i samhället bestäms av politiska beslut. Även på fem och tio års sikt väntas möjligheterna till arbete bli goda.\n\nprognos på ett års sikt \ndet finns cirka 20 000 yrkesverksamma poliser i Sverige, enligt Polismyndigheten.\n\nEfterfrågan på poliser väntas öka det närmaste året i takt med att befolkningen ökar. Hur många poliser som finns i samhället bestäms av regeringen. Antalet utbildningsplatser är därmed anpassade efter förväntat behov och resurser. Söktrycket på polisutbildningen är högt, vilket innebär att det är stor konkurrerens om utbildningsplatserna. Den som klarar utbildningen och aspiranttiden har inga svårigheter att få anställning som polis. Det innebär att det i praktiken inte finns någon arbetslöshet bland poliser.\n\nprognos på fem och tio års sikt \narbetsförmedlingen bedömer att arbetsmarknaden för poliser blir god både på fem och tio års sikt.\n\nefterfrågan på poliser väntas öka något de närmaste tio åren. Antalet poliser i samhället bestäms av politiska beslut. Förändringar i samhället kan påverka behovet av antalet poliser ytterligare.\n\ntillgången på poliser väntas möta efterfrågan eftersom antalet utbildningsplatser anpassas till förväntat behov." } XML <Prognos> <PrognosID>4740</PrognosID> <Prognosrubrik>Poliser</Prognosrubrik> <Yrkesomrade>Säkerhetsarbete</Yrkesomrade> <YrkesomradeID>17</YrkesomradeID> <Yrkesgrupp>Poliser</Yrkesgrupp> <YrkesgruppID>345</YrkesgruppID> <Undergrupp>Poliser</Undergrupp> <UndergruppID>3450</UndergruppID> <Yrkesbenamning/> <YrkesbenamningID/> <Publiceringsdatum>2016-06-29 00:00:00</Publiceringsdatum> <Status>Publicerad</Status> <Barometer10Ar>4</Barometer10Ar>

Sida: 22 av 23 <Barometer5Ar>4</Barometer5Ar> <PrognosbeskrivningHTML> <p><strong>arbetsförmedlingen bedömer att poliser har goda möjligheter till arbete under det närmaste året. Antalet poliser i samhället bestäms av politiska beslut. Även på fem och tio års sikt väntas möjligheterna till arbete bli goda.<br /><br /></strong><strong><font size="3">prognos på ett års sikt <br /></font></strong>det finns cirka 20 000 yrkesverksamma poliser i Sverige, enligt Polismyndigheten.<br /><br /><strong>efterfrågan</strong> på poliser väntas öka det närmaste året i takt med att befolkningen ökar. Hur många poliser som finns i samhället bestäms av regeringen. Antalet utbildningsplatser är därmed anpassade efter förväntat behov och resurser. Söktrycket på polisutbildningen är högt, vilket innebär att det är stor konkurrerens om utbildningsplatserna. Den som klarar utbildningen och aspiranttiden har inga svårigheter att få anställning som polis. Det innebär att det i praktiken inte finns någon arbetslöshet bland poliser.<br /><br /><strong><font size="3">prognos på fem och tio års sikt <br /></font></strong>arbetsförmedlingen bedömer att arbetsmarknaden för poliser blir god både på fem och tio års sikt.<br /><br /><strong>efterfrågan</strong> på poliser väntas öka något de närmaste tio åren. Antalet poliser i samhället bestäms av politiska beslut. Förändringar i samhället kan påverka behovet av antalet poliser ytterligare.<br /><br /><strong>tillgången</strong> på poliser väntas möta efterfrågan eftersom antalet utbildningsplatser anpassas till förväntat behov.</p> </PrognosbeskrivningHTML> <Prognosbeskrivning> Arbetsförmedlingen bedömer att poliser har goda möjligheter till arbete under det närmaste året. Antalet poliser i samhället bestäms av politiska beslut. Även på fem och tio års sikt väntas möjligheterna till arbete bli goda. Prognos på ett års sikt Det finns cirka 20 000 yrkesverksamma poliser i Sverige, enligt Polismyndigheten. Efterfrågan på poliser väntas öka det närmaste året i takt med att befolkningen ökar. Hur många poliser som finns i samhället bestäms av regeringen. Antalet utbildningsplatser är därmed anpassade efter förväntat behov och resurser. Söktrycket på polisutbildningen är högt, vilket innebär att det är stor konkurrerens om utbildningsplatserna. Den som klarar utbildningen och aspiranttiden har inga svårigheter att få anställning som polis. Det innebär att det i praktiken inte finns någon arbetslöshet bland poliser. Prognos på fem och tio års sikt Arbetsförmedlingen bedömer att arbetsmarknaden för poliser blir god både på fem och tio års sikt. Efterfrågan på poliser väntas öka något de närmaste tio åren. Antalet poliser i samhället

Sida: 23 av 23 bestäms av politiska beslut. Förändringar i samhället kan påverka behovet av antalet poliser ytterligare. Tillgången på poliser väntas möta efterfrågan eftersom antalet utbildningsplatser anpassas till förväntat behov. </Prognosbeskrivning> </Prognos> 4 Felhantering 4.1 Statuskoder Följande http-statuskoder returneras av API:et: Statuskod Statustext Beskrivning 200 OK Då requesten är rätt. 400 BAD REQUEST Felaktig inparameter vid REST-anrop. 404 NOT FOUND Ej hittat i underliggande system vid sökning(ars) 500 INTERNAL SERVER ERROR Internt fel vid anrop, då ex. bakomliggande system ligger nere. Tabell 10 Statuskoder 4.2 Fel-Response Vid större fel (500), så returneras en unik felkod som kallas Error UUID.