Bruk av våre data
Finansportalen stiller sine data gratis til rådighet.
Finansportalen samler inn renter og gebyrer for de fleste banker som opererer i Norge.
Dataene vi viser om verdipapirfond kjøper vi selv fra Oslo Børs Informasjon AS og Morningstar. For verdipapirfond og forsikringspriser, har vi derfor ikke data vi kan dele.
Våre data deles gjennom et REST-basert api med JSON formatert data.
For gratis tilgang til våre rådata, for bruk i eksterne applikasjoner, må man undertegne en distribusjonsavtale med oss. Når avtalen er inngått, så vil distributøren motta et brukernavn og passord, samt dokumentasjon om endepunkter.
Distribusjonsavtale med Finansportalen
For tilgang til våre data-feeder, må du inngå en distribusjonsavtale med Finansportalen. Vi har laget en standard avtaletekst, hvor de viktigste punktene er at vi ber deg love å ikke ta data ut av sin sammenheng, samt å holde dataene oppdaterte.
For initiering av distribusjonsavtale med Finansportalen, vennligst send en scan av signert avtale til e-post-adressen “support-fp@forbrukerradet.no”.
Logo for distributører
Distributører skal benytte én av følgende “Data levert av Finansportalen” logoer:
PNG-format
Sort-hvit logo
Fargelogo
SVG-format
Sort-hvit logo
Fargelogo
Integrerbare sammenligningsverktøy
Alle sammenligningsverktøyene til Finansportalen er integrerbare. De kan inkluderes på eksterne nettsider, ved bruk av enkel HTML-kode (iFrame løsning). Disse “portable kalkulatorene” kan benyttes uten distribusjonsavtale, såfremt de kjøres som de er. Det er ikke tillatt å kopiere og manipulere kildekoden, eller benytte datafeeden til de portable kalkulatorene uten etter avtale med Finansportalen.
Oversikt over våre integrerbare sammenligningsverktøy
https://www.forbrukerradet.no/finansportalen/bank/iframe/lan/boliglan
https://www.forbrukerradet.no/finansportalen/bank/iframe/lan/kjoretoy
https://www.forbrukerradet.no/finansportalen/bank/iframe/innskudd
https://www.forbrukerradet.no/finansportalen/bank/iframe/dagligbank
https://www.forbrukerradet.no/finansportalen/bank/iframe/kredittkort
https://www.forbrukerradet.no/finansportalen/bank/iframe/bsu
https://www.forbrukerradet.no/finansportalen/bank/iframe/historisk/innskudd
https://www.forbrukerradet.no/finansportalen/bank/iframe/historisk/boliglan
Kodeeksempler for integrering
IFRAME MED GITT HØYDE OG BREDDE
Merk at høyden som benyttes vil måtte tilpasses verktøyet man integrerer.
Levering av data fra Forbrukerrådets feed
Forbrukerrådets banktjeneste tilbyr en samling REST-endepunkter for maskinell levering
av data. Endepunktene er dokumentert i Swagger her:
https://finans-api.forbrukerradet.no/swagger/feed/
Autentisering
Alle endepunkter er beskyttet og krever et gyldig JWT access token, som må sendes som
en Bearer-token i Authorization-headeren.
For å hente et access token, bruk /auth/token-endepunktet:
https://finans-api.forbrukerradet.no/swagger/feed/#/Authentication/post_auth_token
Velg external_consumer som grantType.
Fyll inn clientId og clientSecret som dere fått levert av Forbrukerrådet
Endepunktet returnerer blant annet et accessToken med 60 minutters levetid.
Bruk av access token
Ved kall til API-endepunktene skal access token sendes i HTTP-headeren slik:
Authorization: Bearer
Se Swagger-dokumentasjonen for detaljer om tilgjengelige endepunkter, parametre og
datamodeller.
Eksempler med curl
Hente access token
curl -X POST "https://finans-api.forbrukerradet.no/auth/token" ^
-H "Content-Type: application/json" ^
-d "{
\"grantType\": \"external_consumer\",
\"clientId\": \"\",
\"clientSecret\": \"\"
}"
Dette vil gi et svar som inneholder blant annet accessToken.
Kalle et data-endepunkt med access token
Når du har fått tak i access token, kan du bruke det slik for å hente ut selskaper:
curl -X GET "https://finans-api.forbrukerradet.no/feed/banks" ^
-H "Authorization: Bearer "
Bytt ut med tokenet du fikk fra forrige steg.
Tips:
Du finner mer informasjon om alle tilgjengelige endepunkter, parametre og
datamodeller i Swagger-dokumentasjonen:
https://finans-api.forbrukerradet.no/swagger/feed/