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.