Kom i gang

Velkommen til OFV Data API-portalen. Denne guiden viser deg hvordan du får tilgang til API-ene våre og begynner å bruke dem.

Steg 1: Opprett en konto

For å få tilgang til API-portalen må du opprette en konto:

  1. Klikk på Registrer deg øverst til høyre på denne siden.

  2. Logg inn med Microsoft- eller Google-kontoen din.

  3. Fyll ut registreringsskjemaet.

Steg 2: Be om API-tilgang

Når kontoen din er opprettet, må du be om tilgang til de spesifikke API-produktene du ønsker å bruke.

  1. Send en e-post til support@ofv.no med følgende informasjon:

    • E-postadressen du registrerte deg med

    • Hvilke(t) API du ønsker tilgang til (f.eks. Transaction API, Registrations API)

    • Firmanavn og en kort beskrivelse av bruksområdet

  2. Teamet vårt vil vurdere forespørselen din og gi tilgang til riktig produktabonnement.

  3. Du vil motta en bekreftelses-e-post når tilgangen er gitt.

Steg 3: Hent abonnementsnøkkelen din

Etter at tilgangen din er godkjent:

  1. Logg inn på denne portalen.

  2. Gå til profilsiden din.

  3. Under Subscriptions finner du abonnementsnøkkelen(e) dine.

  4. Kopier Primary key — denne brukes til å autentisere API-forespørslene dine.

Viktig: Hold abonnementsnøkkelen konfidensiell. Ikke del den offentlig eller legg den inn i kildekode.

Steg 4: Gjør ditt første API-kall

Inkluder abonnementsnøkkelen din i hver API-forespørsel ved hjelp av HTTP-headeren:

Ocp-Apim-Subscription-Key: your-subscription-key-here

For fullstendig dokumentasjon for hvert API, inkludert tilgjengelige filtre, eksempelforespørsler og responsformater, se:

  • Transaction API — Transaksjonsdata for kjøretøyeierskap (salg, overdragelser, førstegangsregistreringer)

  • Registrations API — Kjøretøyregistreringsdata og tekniske spesifikasjoner

Du kan også bla gjennom alle tilgjengelige API-er på APIs-siden.

Ratebegrensninger og kvoter

Abonnementet ditt inkluderer både en ratebegrensning og en kvote, konfigurert basert på avtalen din:

  • Ratebegrensning — Styrer hvor mange forespørsler du kan gjøre i et kort tidsvindu (burst-beskyttelse). Overskrider du ratebegrensningen, vil du motta et 429 Too Many Requests-svar. Vent til tidsvinduet tilbakestilles og prøv igjen.

  • Kvote — Styrer det totale antallet forespørsler over en lengre periode (f.eks. ukentlig). Når kvoten er brukt opp, vil ytterligere forespørsler bli avvist til kvoten tilbakestilles.

Du kan overvåke forbruket ditt via responshodene på hvert API-kall:

  • X-RateLimit-Limit — Maks antall forespørsler tillatt i gjeldende tidsvindu

  • X-RateLimit-Remaining — Gjenværende forespørsler i gjeldende tidsvindu

  • X-RateLimit-Reset — Sekunder til tidsvinduet tilbakestilles

  • X-Quota-Limit — Totalt antall forespørsler tillatt i gjeldende kvoteperiode

  • X-Quota-Reset — Intervall for kvotetilbakestilling (f.eks. "weekly")

Hvis du trenger å justere ratebegrensningene eller kvoten din, kontakt support@ofv.no.

Trenger du hjelp?

Har du spørsmål eller trenger hjelp, kontakt oss på support@ofv.no.

For fullstendige tekniske API-spesifikasjoner (skjemaer, responsformater, feilkoder), se APIs-siden.