Oversikt
Statens vegvesen tilbyr et REST-basert API som kan benyttes for å få tilgang til informasjonen som befinner seg i
Feilhåndtering
APIet har som mål å feile så raskt som mulig for å assistere brukeren. I den grad det er mulig vil alle kall til
Sporing av requester
I APIets interne request-logg tar vi vare på to headere for hver request for å identifisere klienten, X-Client og User-Agent.
Paginering
Spørringer mot NVDB API kan potensielt returnere et stort antall objekter.
Responsrevisjon
For å kunne gjøre endringer i responsformatet for APIet har vi en egen Content-Type som er versjonert.
Avanserte filtre
API-et kan utføre komplekse spørringer som filtrerer på relaterte objekter og objekter som overlapper
Integrasjon
Dagens implementasjon av API Les lar deg ikke generere klienter fra OpenAPI dokumentet. Det pågår arbeid for å få endret på dette. Inntil videre har vi en Javaklient man kan bruke.
Overbelastning
Dersom det er mye last, som ikke trigger HTTP 429 (se Ratelimiter),
Ratelimiter
API-et implementerer en ratelimiter for å forhindre overbelastning. Denne opererer med tre parametere: Tidsvindu-størrelse, antall kall og timeout.
Tid
Flere av endepunktene aksepterer tidsparametere. Disse må våre på format ISO 8601:
Vegsystemreferanse
Vegsystemreferansen er erstatning for Vegreferanse (vegobjekttype 532). Vegsystemreferansen er satt sammen av