際際滷

際際滷Share a Scribd company logo
Jan Bruusgaard
Seksjon web og Statistikkbank
Lansering 2. mai 20161
Hvordan bruke API-et til SSB
Oversikt
 API-et p奪 5 minutter
 Plassere nytt API i en st淡rre sammenheng
 Detaljert om API-et
og ressurser for 奪 bruke det
 Adresse: http://www.ssb.no/api
Konsoll
Bakgrunn
 Nordisk samarbeid om Statistikkbank fra 2001
 Beta-API 2013
 Fortsetter som f淡r, ute av beta med nytt navn:
 API: Ferdige datasett
 Utformater
 JSON-stat
 CSV
 http GET
 API: Lag egne datasett
 Resultat av nordisk samarbeid
API er for v奪re mest avanserte brukere
API: Lag egne datasett (POST)
API: Ferdige datasett (GET)
Mitt SSB - lagret s淡k mot Statistikkbanken
Statistikkbanken
Statistikk med ferdigtabeller
N淡kkeltall
API: Lag egne datasett
 Best奪r av to deler
 API konsoll
 http://data.ssb.no/api/v0/no/console
 Egenutviklet
 API Direkte til datasettene (PX-API)
 http://data.ssb.no/api/v0/no/table
 Del av PX-Web
 Utviklet av SCB (Sverige), med bistand fra SSB
 Felles videreutvikling
 http POST
6
Sp淡rringer
 JSON
 Enkel og kompakt
 ferdige biblioteker
 enkelt 奪 l脱re grunnleggende syntaks
 tar mer og mer over for XML
Sp淡rring - filter
 Item
 enkeltverdier
 All
 Trunkering *
 Top
 Siste / 淡verste verdier
 Egnet for tid
8
Output formater
 JSON-stat
 Anbefalt, forh奪ndsvalgt i konsoll-sp淡rring
 CSV (kommaseparert)
 XLSX (Excel)
 PX (PC-Axis)
 JSON (SCBs versjon, key: values)
9
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).
 503  time-out etter 60 sekunder
10
11
Direkte til datasettene - via url
 anbefalinger
 Jsonviewer og poster
 Begge finnes b奪de for Chromium og Firefox
 Curl
 ikke bruke IE
 For lenker se brukerveiledningen
Direkte til datasettene - via url
 http://data.ssb.no/api/v0/no/table/
 JSON
 {id
 {text
13
S淡k med URL
 ?query=
 s淡ker ogs奪 variabler
 Filter  title
 Begrenser til tittel
 S淡k med Tabellid for 奪 finne tabellnummer:
http://data.ssb.no/api/v0/no/table/?query=folkframt6
 space gir AND
 husk at en del er p奪 nynorsk
 Lucene 3.9.4 (Windows)
14
Sp淡rring i konsoll
 Mer bruk av filtrene
 All
 Top
 Utformatene
 CSV
 desimaltegn .
 Skilletegn ,
 Metadatafanen
Kjente mangler
 Metadata viser ikke aggregeringer og
grupperinger
 Ikke stol 100% p奪 datoer
 Ingen informasjon om neste publisering
 束Forel淡pige tall損 vises forskjellig eller
markeres ikke i det hele tatt
 Se detaljert liste over feil og mangler i
brukerveiledningen
Ressurser
 JSON-stat
 har ferdige biblioteker
 http://json-stat.org
 Enkle POST eksempler
 http://www.ssb.no/253074/eksempler-pa-kode
 Python
 R
 Microsoft Power BI / Power Query
 SAS
Hva skjer framover
 feilrettinger
 Ny statistikkbank basert p奪 PX-web
 videreutvikling API som del av PX-web
 Ny datamodell
 vil bl.a. ha hierarkiske variabler
 json-stat 2.0
 n奪 har vi versjon 0.99
 KLASS  ny standarddatabase med eget API
 KOSTRA modernisering planlegger 奪 bruke API-et
Tips: Unng奪 9-11 - om du kan
 om du kan,
unng奪 奪 sp淡rre API-et fra kl. 9-11
 9-10 fordi det skjer oppdateringer
 10-11 mest for de med behov for raske data,
kan v脱re h淡y trafikk
Lansering 2. mai 201619

More Related Content

Hvordan bruke API-et til SSB

  • 1. Jan Bruusgaard Seksjon web og Statistikkbank Lansering 2. mai 20161 Hvordan bruke API-et til SSB
  • 2. Oversikt API-et p奪 5 minutter Plassere nytt API i en st淡rre sammenheng Detaljert om API-et og ressurser for 奪 bruke det Adresse: http://www.ssb.no/api
  • 4. Bakgrunn Nordisk samarbeid om Statistikkbank fra 2001 Beta-API 2013 Fortsetter som f淡r, ute av beta med nytt navn: API: Ferdige datasett Utformater JSON-stat CSV http GET API: Lag egne datasett Resultat av nordisk samarbeid
  • 5. API er for v奪re mest avanserte brukere API: Lag egne datasett (POST) API: Ferdige datasett (GET) Mitt SSB - lagret s淡k mot Statistikkbanken Statistikkbanken Statistikk med ferdigtabeller N淡kkeltall
  • 6. API: Lag egne datasett Best奪r av to deler API konsoll http://data.ssb.no/api/v0/no/console Egenutviklet API Direkte til datasettene (PX-API) http://data.ssb.no/api/v0/no/table Del av PX-Web Utviklet av SCB (Sverige), med bistand fra SSB Felles videreutvikling http POST 6
  • 7. Sp淡rringer JSON Enkel og kompakt ferdige biblioteker enkelt 奪 l脱re grunnleggende syntaks tar mer og mer over for XML
  • 8. Sp淡rring - filter Item enkeltverdier All Trunkering * Top Siste / 淡verste verdier Egnet for tid 8
  • 9. Output formater JSON-stat Anbefalt, forh奪ndsvalgt i konsoll-sp淡rring CSV (kommaseparert) XLSX (Excel) PX (PC-Axis) JSON (SCBs versjon, key: values) 9
  • 10. 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). 503 time-out etter 60 sekunder 10
  • 11. 11
  • 12. Direkte til datasettene - via url anbefalinger Jsonviewer og poster Begge finnes b奪de for Chromium og Firefox Curl ikke bruke IE For lenker se brukerveiledningen
  • 13. Direkte til datasettene - via url http://data.ssb.no/api/v0/no/table/ JSON {id {text 13
  • 14. S淡k med URL ?query= s淡ker ogs奪 variabler Filter title Begrenser til tittel S淡k med Tabellid for 奪 finne tabellnummer: http://data.ssb.no/api/v0/no/table/?query=folkframt6 space gir AND husk at en del er p奪 nynorsk Lucene 3.9.4 (Windows) 14
  • 15. Sp淡rring i konsoll Mer bruk av filtrene All Top Utformatene CSV desimaltegn . Skilletegn , Metadatafanen
  • 16. Kjente mangler Metadata viser ikke aggregeringer og grupperinger Ikke stol 100% p奪 datoer Ingen informasjon om neste publisering 束Forel淡pige tall損 vises forskjellig eller markeres ikke i det hele tatt Se detaljert liste over feil og mangler i brukerveiledningen
  • 17. Ressurser JSON-stat har ferdige biblioteker http://json-stat.org Enkle POST eksempler http://www.ssb.no/253074/eksempler-pa-kode Python R Microsoft Power BI / Power Query SAS
  • 18. Hva skjer framover feilrettinger Ny statistikkbank basert p奪 PX-web videreutvikling API som del av PX-web Ny datamodell vil bl.a. ha hierarkiske variabler json-stat 2.0 n奪 har vi versjon 0.99 KLASS ny standarddatabase med eget API KOSTRA modernisering planlegger 奪 bruke API-et
  • 19. Tips: Unng奪 9-11 - om du kan om du kan, unng奪 奪 sp淡rre API-et fra kl. 9-11 9-10 fordi det skjer oppdateringer 10-11 mest for de med behov for raske data, kan v脱re h淡y trafikk Lansering 2. mai 201619