Uljas API

Företag och privatpersoner har tillgång till Tullens statistik om utrikeshandeln i digital form. Data och tillhörande metadata från Tullens Uljas statistikdatabas kan föras över digitalt via ett programmeringsgränssnitt med Application Programming Interface (API). API:er kan bearbetas och till exempel användas för att bygga appar för smarta telefoner eller nya webbtjänster. Formatet är csv, json, json-stat eller xml. HTTP GET eller POST frågor används vid dataförfrågningar. Förfrågningen bestäms med olika parametrar. 

Det offentliga statistikinnehållet i Tullens Uljas- webbtjänst omfattas av användartillståndet Creative Commons Erkännande 4.0 som är ett användartillstånd enligt rekommendationen JHS 189 för öppen data inom den offentliga förvaltningen.

Det ger tillstånd att fritt använda statistikdata förutsatt att källan anges.Genom att motta, ladda ned eller på annat sätt ta del av material godkänner användaren dessa användarvillkor.

Fyra olika typer av frågor kan formuleras mot Statistikdatabasens gränssnitt. De tre första söktyperna gäller för metadeta och den fjärde för statistikvariablar:

*Stats

Returnerar data från databasens statistikkuber.
Exempel: https://uljas.tulli.fi/uljas/graph/api.aspx?lang=sv&atype=stats&konv=json

*Dims

Returnerar data gällande dimensioner för en bestämd statistikkub, dvs. en lista över de klassifikationer som används i tabellen.  ("dimensions").
Exempel: https://uljas.tulli.fi/uljas/graph/api.aspx?lang=sv&atype=dims&konv=json&ifile=/DATABASE/01%20ULKOMAANKAUPPATILASTOT/02%20SITC/ULJAS_SITC

*Class

Returnerar variabler för klassifikationen i statistikkuben ("classification").
Exempel: https://uljas.tulli.fi/uljas/graph/api.aspx?lang=sv&atype=class&konv=json&ifile=/DATABASE/01%20ULKOMAANKAUPPATILASTOT/02%20SITC/ULJAS_SITC

*Data

Returnerar statistikvärden som är givna för de valda variablerna inom klassifikationen.  
Exempel: https://uljas.tulli.fi/uljas/graph/api.aspx?lang=sv&atype=data&konv=json&ifile=/DATABASE/01%20ULKOMAANKAUPPATILASTOT/02%20SITC/ULJAS_SITC&Varuklassifikation%20SITC1=0-9&Land=DE&Tid==FIRST*;12&Riktning=2&Indikator=V1

En enskild förfrågans returnering är begränsad till 50 000 celler.

Vänligen läs API:s bruksanvisning noggrant före användning (enbart på engelska).

Tullen tillhandahåller tjänsten i befintligt skick och tar inte ansvar för eventuella störningar eller för produkter som baseras på tjänsten.