menu

Application programming interface/API

Interface til information om brændstofpriser i Skandinavien (Danmark, Sverige og Norge).

Der er adgang til data mod betaling. Teknisk sker det vha. en API nøgle, og forespørgslen vil blive besvaret med en JSON formateret fil.

Der tilbydes 2 muligheder, hvor det handler om laveste, gennemsnitlige og højeste priser.

Aktuelle gennemsnitspriser
Aktuelle og historiske gennemsnitspriser
Betalingsbetingelser
Bestilling af API nøgler og adgang

Priserne på benzin(petrol) og diesel er beregnet på henholdsvis blyfri benzin 95 (E10) og diesel (B7).

  • Laveste pris kommer typisk fra ubemandede tankstationer.
  • Gennemsnitspris er den beregnede pris for alle danske tankstationer afhængig af placering og type.
  • Højeste pris kommer typisk fra danske tankstationer ved motorvejen.

Aktuelle gennemsnitspriser

Information om aktuelle (laveste, gennemsnitlige og højeste) priser for benzin og diesel på danske tankstationer, samt tidspunkt for priserne og antal forespørgsler i denne måned.

Eksempel i formateret json

Eksempelvis:

{"created":"2022-11-14 16:50:43",
"petrol":{"min":"14.69","avg":"14.719786","max":"15.99"},
"diesel":{"min":"15.09","avg":"15.119735","max":"16.39"},
"count":55}

min: laveste tilbudte pris
avg: gennemsnitsprisen for alle forskellige typer danske tankstationer
max: højeste tilbudte pris
created: tidspunkt for generering af data
count: løbende forbrug af forespørgsler for måneden

Pris matrix

Månedlige forespørgsler 10.000 50.000 100.000
Beregnes hver time 75,00 300,00 500,00
Beregnes hver 15. min 100,00 425,00 750,00
Beregnes løbende 150,00 675,00 1.250,00
API nøgler 1 2 5

Priserne er i kr./md. og eksklusive moms.

Kald til API'et

Beskrivelse af hvorledes man får adgang til data, og hvordan API nøgle skal anvendes fås efter bestilling af adgang.

HTTP:

https://fuelfinder.dk/customerapi/denmark/currentprice?api_key={api_key}&username:{email}

cURL:

curl -L https://fuelfinder.dk/customerapi/denmark/currentprice -H 'accept: application/json' -H 'Authorization: Bearer {api_key}' -H 'username: {email}' -H 'User-Agent: fuelfinder/apiinterface'

Alternativt:

curl -X GET https://fuelfinder.dk/customerapi/denmark/currentprice/ -H 'accept: application/json' -H 'Authorization: Bearer {api_key}' -H 'username: {email}' -H ' User-Agent: Mozilla/5.0 (Macintosh; Intel Mac OS X 10.9; rv:50.0) Gecko/20100101 Firefox/50.0'

Aktuelle og historiske gennemsnitspriser

Information om aktuelle og historiske (laveste, gennemsnitlige og højeste) priser for benzin og diesel på danske tankstationer, samt tidspunkt for generering af priserne og antal forespørgsler i denne måned.

Eksempel i formatteret json

Eksempelvis:

{{"created":"2022-12-14 08:05:03",
"today":{"petrol":{"min":"12.89","avg":"12.923285","max":"14.19"},"diesel":{"min":"12.79","avg":"12.823269","max":"14.09"}},
"one month ago":{"petrol":{"min":"14.69","avg":14.731444,"max":"15.99"},"diesel":{"min":"14.89","avg":14.931444,"max":"16.19"}},
"six months ago":{"petrol":{"min":"17.89","avg":17.931444,"max":"19.19"},"diesel":{"min":"16.59","avg":16.631444,"max":"17.89"}},
"one year ago":{"petrol":{"min":"12.59","avg":12.631444,"max":"13.89"},"diesel":{"min":"11.09","avg":11.131444,"max":"12.39"}},
"count":23}

"created": tidspunkt for generering af data
"today": aktuelle priser
"one month ago": priser for en måned siden med hensyntagen til tidspunkt på dagen
"six months ago": priser for et halv år siden med hensyntagen til tidspunkt på dagen
"one year ago": priser for en år siden med hensyntagen til tidspunkt på dagen
"count": løbende forbrug af forespørgsler for måneden

Pris matrix

Månedlige forespørgsler 10.000 50.000 100.000
Beregnes hver time 200,00 800,00 1.333,00
Beregnes hver 15. min 267,00 1.133,00 2.000,00
Beregnes løbende 400,00 1.800,00 3.333,00
API nøgler 1 2 5

Priserne er i kr./md. og eksklusive moms.

Kald til API'et

Beskrivelse af hvorledes man får adgang til data, og hvordan API nøgle skal anvendes fås efter bestilling af adgang.

HTTP:

https://fuelfinder.dk/customerapi/denmark/currentprice?api_key={api_key}&username:{email}&average=history

cURL:

curl -L https://fuelfinder.dk/customerapi/denmark/currentprice -H 'accept: application/json' -H 'Authorization: Bearer {api_key}' -H 'username: {email}' -H 'average: history' -H 'User-Agent: fuelfinder/apiinterface'

Alternativt:

curl -X GET https://fuelfinder.dk/customerapi/denmark/currentprice/ -H 'accept: application/json' -H 'Authorization: Bearer {api_key}' -H 'username: {email}' -H 'average: history' -H ' User-Agent: Mozilla/5.0 (Macintosh; Intel Mac OS X 10.9; rv:50.0) Gecko/20100101 Firefox/50.0'

Betaling

Den månedlige betalingen dækker over:

  • Hvor mange forespørgsler pr. måned: 10.000, 50.000 eller 100.000
  • Hvornår der skal beregnes: hver time, 15. min eller løbende
  • Hvor mange API-nøgler
  • Om det er historisk eller aktuelle gennemsnitspriser

Prisen for adgangen fremgår af en af de to pris-matrixer.

Der faktureres månedlig bagud, og faktura vil indeholde oplysninger om antal anvendte forespørgsler. Beløbet er i danske kroner og eksklusive moms.

Det er ikke muligt af afregne via betalingsservice. Automatisk overførelse er altid en mulig, og faktura vil stadig blive fremsendt elektronisk som en PDF-fil.

Bestilling af API nøgler og adgang