際際滷

際際滷Share a Scribd company logo
Jan Bruusgaard
Seksjon web og Statistikkbank
Difi Datadelingsforum / #hack4no 31.8.20161
SSBs API mot Statistikkbanken
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
Hva kan en bruke SSBs API til
SSB API3
 hente data automatisk inn i:
 Tekst
 Figur / visualisering
 Tabell
 Webapplikasjon
 Database
 Analyseverkt淡y
 SAS, R etc.
SSB har 2 API-er
SSB API4
 Ferdige datasett (lansert juni 2013)
 Lag egne datasett (kom mai 2016)
API: Ferdige datasett
SSB API
5
 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
API: Lag egne datasett
SSB API6
 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
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
7
SSBs API mot Statistikkbanken
Sp淡rringer
 Formuleres i JSON-format
 Enkel og kompakt
 enkelt 奪 l脱re grunnleggende syntaks
Sp淡rring - filter
 Item
 enkeltverdier
 All
 Trunkering *
 Bare * - velger alle
 Top
 Siste / 淡verste verdier
 Egnet for rullerende tid
SSB API10
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)
SSB API11
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
SSB API12
Direkte til datasettene  via url
 http://data.ssb.no/api/v0/no/table/
 JSON
 {id  text }
 POST mot url
SSB API13
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
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
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
SSBs API: Oppsummert
SSB API17
 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: statistikkbanken@ssb.no (evt. jbr@ssb.no)

More Related Content

SSBs API mot Statistikkbanken

  • 1. Jan Bruusgaard Seksjon web og Statistikkbank Difi Datadelingsforum / #hack4no 31.8.20161 SSBs API mot Statistikkbanken
  • 2. 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
  • 3. Hva kan en bruke SSBs API til SSB API3 hente data automatisk inn i: Tekst Figur / visualisering Tabell Webapplikasjon Database Analyseverkt淡y SAS, R etc.
  • 4. SSB har 2 API-er SSB API4 Ferdige datasett (lansert juni 2013) Lag egne datasett (kom mai 2016)
  • 5. API: Ferdige datasett SSB API 5 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
  • 6. API: Lag egne datasett SSB API6 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
  • 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 7
  • 9. Sp淡rringer Formuleres i JSON-format Enkel og kompakt enkelt 奪 l脱re grunnleggende syntaks
  • 10. Sp淡rring - filter Item enkeltverdier All Trunkering * Bare * - velger alle Top Siste / 淡verste verdier Egnet for rullerende tid SSB API10
  • 11. 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) SSB API11
  • 12. 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 SSB API12
  • 13. Direkte til datasettene via url http://data.ssb.no/api/v0/no/table/ JSON {id text } POST mot url SSB API13
  • 14. 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
  • 15. 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
  • 16. 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
  • 17. SSBs API: Oppsummert SSB API17 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: statistikkbanken@ssb.no (evt. jbr@ssb.no)

Editor's Notes

  • #3: Kort om APIet vi har hatt siden 2013, detaljert om det nye APIet og til slutt noen anbefalte ressurser for 奪 anvende det. Alt er b奪de p奪 norsk og engelsk
  • #4: Bloomberg publiserer nyheter et par sekunder etter oss, oversetter minus til underskudd. Robotjournalistikk kommer, Finn tall for din kommune.
  • #6: Da vi kom med v奪rt beta-Api i 2013 var SSB f淡rste nasjonale statistikkbyr奪byr奪 til 奪 ta i bruk formatet JSON-stat. Det er spesielt egnet for statistikk eller mangedimensjonale datakuber.
  • #7: 500.000 celler inkluderer ogs奪 celler uten verdier
  • #8: Best奪r av alts奪 av to deler API konsoll Egenutviklet API Direkte til datasettene (PX-API) API (PX-API) f淡rste skritt mot ny Statstikkbank (PX-web) Det aller viktigste 奪 gj淡re oppmerksom p奪 er at det nye APIet bruker protokollen http POST. Det er uvanlig. Ogs奪 for it-folk som jobber lite med web er dette ukjent.
  • #9: G奪 til http://www.ssb.no/omssb/tjenester-og-verktoy/api Den enkle m奪ten 奪 bruke det nye APIet er Velg Lag egne datasett - konsoll S淡k folkemengde ett奪rig alder nullstill tabellnummer 07459 Eksempelsp淡rring - 3 f淡rste av hver variabel - JSON Velg Kj淡r Vis resultatrute JSON-stat Rediger sp淡rring 奪r 2016 - Kj淡r Vis response endre til csv
  • #10: Enkel og kompakt enkelt 奪 l脱re grunnleggende syntaks ogs奪 for ikke programmerere Mange ferdige biblioteker tar mer og mer over for XML Sp淡rring innledes med {束query損
  • #11: Item enkeltverdier All Trunkering * Top Siste / 淡verste verdier Egnet for tid her et et eksempel med siste 13 m奪neder for regne ut prosentvis 奪rsendring. Tid Top 1 sikrer alltid siste tall Det finnes to filtre til for aggregeringer og grupperinger, men de vises ikke i metadata (kommer)
  • #12: JSON-stat tilbys n奪 av alle nordiske statistikkbyr奪er, samt Eurostat. Veldig mange norske data leveres til Eurostat som er EUs statistikkkontor. Om en vil sammenlikne Norske data med andre Europeiske land, kan det v脱re verdt 奪 sjekke
  • #17: JSON-stat har ferdige biblioteker Enkle POST eksempler Python R Microsoft Power BI / Power Query SAS For lenker, se brukerveiledningen