Uljas API

Yritykset ja yksityishenkilöt voivat hakea Tullin ulkomaankaupan tilastotietoja koneellisesti. Tullin Uljas-tilastotietokannan avoimen datan rajapinta eli API (Application Programming Interface) mahdollistaa tilastotietojen ja niiden metadatan hakemisen Uljas-tietokannasta csv, json, json-stat ja xml -muodoissa. Tiedot haetaan HTTP GET tai POST -kyselyillä. Kysely yksilöidään parametreilla. API:n avulla voidaan rakentaa esimerkiksi erilaisia ulkomaankauppatilastoihin perustuvia verkkopalveluja tai sovelluksia.

Tullin Uljas-tietokannassa julkaistuja tilastoaineistoja koskee Creative Commons Nimeä 4.0 -käyttölupa, joka on JHS 189 -suosituksen mukainen käyttölupa julkishallinnon avoimia tietoaineistoja varten.

Tilastoaineistoja voi vapaasti käyttää kaikin mahdollisin tavoin edellyttäen, että lähde mainitaan. Vastaanottamalla, lataamalla tai muuten saattamalla aineistoja käyttöönsä käyttäjä hyväksyy nämä käyttöehdot.

Rajapintakyselyitä on neljää eri tyyppiä. Kolme ensimmäistä hakutyyppiä kohdistuvat metadataan, neljäs taas taulukossa oleviin tilastoarvoihin:

*Stats

Palauttaa tietoa tietokannassa olevista tilastokuutioista.
Esimerkki: https://uljas.tulli.fi/uljas/graph/api.aspx?lang=fi&atype=stats&konv=json

*Dims

Palauttaa tietoja tietyn tilastokuution ulottuvuuksista ("dimensions"). Ts. listaus taulukossa käytetyistä luokituksista.
Esimerkki: https://uljas.tulli.fi/uljas/graph/api.aspx?lang=fi&atype=dims&konv=json&ifile=/DATABASE/01%20ULKOMAANKAUPPATILASTOT/02%20SITC/ULJAS_SITC

*Class

Palauttaa tilastokuution luokitusten ("classification") muuttujat.
Esimerkki: https://uljas.tulli.fi/uljas/graph/api.aspx?lang=fi&atype=class&konv=json&ifile=/DATABASE/01%20ULKOMAANKAUPPATILASTOT/02%20SITC/ULJAS_SITC

*Data

Palauttaa tietyillä luokituksen muuttujilla yksilöidyn tilastoarvon tai arvot.
Esimerkki: https://uljas.tulli.fi/uljas/graph/api.aspx?lang=fi&atype=data&konv=json&ifile=/DATABASE/01%20ULKOMAANKAUPPATILASTOT/02%20SITC/ULJAS_SITC&Tavaraluokitus%20SITC1=0-9&Maa=DE&Aika==FIRST*;12&Suunta=2&Indikaattorit=V1

Yksittäisen kyselyn palautuksen koko on rajoitettu 50 000 soluun

Tutustu huolellisesti API:n käyttöohjeeseen (ohje vain englanniksi) ennen rajapinnan käyttöä.

Tulli tarjoaa palvelun as is, eikä ota vastuuta palvelun mahdollisista toimintahäiriöistä eikä sen päälle rakennetuista tuotteista.