ssbs api mot statistikkbanken
TRANSCRIPT
![Page 1: SSBs API mot Statistikkbanken](https://reader036.vdocuments.pub/reader036/viewer/2022062310/58a1c9f31a28ab9d338b6111/html5/thumbnails/1.jpg)
1
Jan BruusgaardSeksjon web og Statistikkbank
Difi Datadelingsforum / #hack4no 31.8.2016
SSBs API mot Statistikkbanken
![Page 2: SSBs API mot Statistikkbanken](https://reader036.vdocuments.pub/reader036/viewer/2022062310/58a1c9f31a28ab9d338b6111/html5/thumbnails/2.jpg)
ssb.no/api
• API mot SSBs «skattkiste» – Statistikkbanken.
• Statistikkbanken har• Mer enn en milliard tall• Fordelt på 5000 tabeller• Av dette 456 tabeller på kommunenivå
• Oppdateres (nesten) hver dag• Tall tilbake til 1769
![Page 3: SSBs API mot Statistikkbanken](https://reader036.vdocuments.pub/reader036/viewer/2022062310/58a1c9f31a28ab9d338b6111/html5/thumbnails/3.jpg)
SSB API3
Hva kan en bruke SSBs API til• hente data automatisk inn i:• Tekst • Figur / visualisering• Tabell• Webapplikasjon• Database• Analyseverktøy
– SAS, R etc.
![Page 4: SSBs API mot Statistikkbanken](https://reader036.vdocuments.pub/reader036/viewer/2022062310/58a1c9f31a28ab9d338b6111/html5/thumbnails/4.jpg)
SSB API4
SSB har 2 API-er• Ferdige datasett (lansert juni 2013)• Lag egne datasett (kom mai 2016)
![Page 5: SSBs API mot Statistikkbanken](https://reader036.vdocuments.pub/reader036/viewer/2022062310/58a1c9f31a28ab9d338b6111/html5/thumbnails/5.jpg)
5
API: Ferdige datasett
SSB API
• SSB lager datasettet• Kun 250 datasett
• Dekker mest etterspurte tabeller• Fordel: SSB holder oversikt over endringene
• Egen adresse (URL) til hvert datasett • http GET
• Utformat• JSON-Stat• CSV
![Page 6: SSBs API mot Statistikkbanken](https://reader036.vdocuments.pub/reader036/viewer/2022062310/58a1c9f31a28ab9d338b6111/html5/thumbnails/6.jpg)
SSB API6
API: Lag egne datasett• Dekker alle 5000
statistikkbanktabellene• Fleksibelt• Bruker definerer selv uttrekk• Velg størrelse fra 1 til 500.000 celler• Høyere maks. grense enn Statistikkbanken• Velger kun variabler en har behov for
![Page 7: SSBs API mot Statistikkbanken](https://reader036.vdocuments.pub/reader036/viewer/2022062310/58a1c9f31a28ab9d338b6111/html5/thumbnails/7.jpg)
7
API: Lag egne datasett
• Består av to deler• API: konsoll• teste og redigere spørringer
• API: Direkte til datasettene • http POST• Poste spørring mot url
• GET for å traversere
![Page 8: SSBs API mot Statistikkbanken](https://reader036.vdocuments.pub/reader036/viewer/2022062310/58a1c9f31a28ab9d338b6111/html5/thumbnails/8.jpg)
![Page 9: SSBs API mot Statistikkbanken](https://reader036.vdocuments.pub/reader036/viewer/2022062310/58a1c9f31a28ab9d338b6111/html5/thumbnails/9.jpg)
Spørringer
• Formuleres i JSON-format• Enkel og kompakt• enkelt å lære grunnleggende syntaks
![Page 10: SSBs API mot Statistikkbanken](https://reader036.vdocuments.pub/reader036/viewer/2022062310/58a1c9f31a28ab9d338b6111/html5/thumbnails/10.jpg)
SSB API10
Spørring - filter
• Item• enkeltverdier
• All• Trunkering *
• Bare * - velger alle
• Top• Siste / øverste verdier• Egnet for rullerende tid
![Page 11: SSBs API mot Statistikkbanken](https://reader036.vdocuments.pub/reader036/viewer/2022062310/58a1c9f31a28ab9d338b6111/html5/thumbnails/11.jpg)
SSB API11
Output formater• JSON-stat (http://json-stat.org) • Anbefalt og forhåndsvalgt i konsoll-spørring• Ferdige bibliotek for
• Javascript• Java• R• Python
• CSV (kommaseparert)• XLSX (Excel)
![Page 12: SSBs API mot Statistikkbanken](https://reader036.vdocuments.pub/reader036/viewer/2022062310/58a1c9f31a28ab9d338b6111/html5/thumbnails/12.jpg)
SSB API12
Statuskoder
• 200 – ok• 404 – feil i URL eller i syntaks på spørringen.• 403 – sperre ved for stort datasett.
500 000 celler (inkl. tomme celler). • 429 – for mange spørringer. Grensen er 30 i
minuttet• 503 – time-out etter 60 sekunder
![Page 13: SSBs API mot Statistikkbanken](https://reader036.vdocuments.pub/reader036/viewer/2022062310/58a1c9f31a28ab9d338b6111/html5/thumbnails/13.jpg)
SSB API13
Direkte til datasettene – via url• http://data.ssb.no/api/v0/no/table/• JSON• {id … text …}
• POST mot url
![Page 14: SSBs API mot Statistikkbanken](https://reader036.vdocuments.pub/reader036/viewer/2022062310/58a1c9f31a28ab9d338b6111/html5/thumbnails/14.jpg)
Kjente mangler
• GET støttes (foreløpig) ikke• Metadata viser ikke aggregeringer og
grupperinger• Ingen informasjon om neste publisering• «Foreløpige tall» vises forskjellig eller
markeres ikke i det hele tatt• Se også brukerveiledningen
![Page 15: SSBs API mot Statistikkbanken](https://reader036.vdocuments.pub/reader036/viewer/2022062310/58a1c9f31a28ab9d338b6111/html5/thumbnails/15.jpg)
Hva skjer framover• JSON-Stat 2.0
• nå har vi versjon 1.2• Ny statistikkbank basert på PX-web / KOSTRA
modernisering• videreutvikling API som del av PX-web
• Støtte for http GET• Ny datamodell
• vil bl.a. ha hierarkiske variabler• KLASS – ny standarddatabase med eget API
![Page 16: SSBs API mot Statistikkbanken](https://reader036.vdocuments.pub/reader036/viewer/2022062310/58a1c9f31a28ab9d338b6111/html5/thumbnails/16.jpg)
Ressurser• Se Brukerveiledningen nytt API for lenker
• Har også enkle eksempler på spørringer med POST i:• Python, R, SAS, Microsoft Power BI / Power Query
• JSON-Stat• json-stat.org
• Se også json-stat.com/nsm – kursmateriale og verktøy
• Nettleser utvidelser• Jsonviewer• Poster
• Curl
![Page 17: SSBs API mot Statistikkbanken](https://reader036.vdocuments.pub/reader036/viewer/2022062310/58a1c9f31a28ab9d338b6111/html5/thumbnails/17.jpg)
SSB API17
SSBs API: Oppsummert• Det nye API-et er best:
• Mest fleksibelt• Lag egne datasett
• Størst • 5000 tabeller, • opptil 500.000 celler pr. spørring
• Det gamle API-et er:• Enklest
• Ferdige datasett• Raskest• Begrenset
• http://www.ssb.no/api• Kontakt: [email protected] (evt. [email protected])