Meld feil og mangler i data (Fiksvegdata)

Systemdokumentasjon for NVDB Fiksvegdata

Denne siden dokumenterer tekniske detaljer for NVDB Fiksvegdata, inkludert bruk av API, miljøspesifikasjoner og eksempler på integrasjon. Innholdet er rettet mot utviklere og andre teknisk interesserte som ønsker å hente, opprette eller administrere feilmeldinger via tjenesten.

Miljøer

NVDB Fiksvegdata er tilgjengelig i tre ulike miljøer hos Statens vegvesen:

Miljø Formål Basis-URL
UTV Utvikling https://fiksvegdata.utv.atlas.vegvesen.no/
ATM Akseptansetesting https://fiksvegdata.test.atlas.vegvesen.no/
Prod Produksjon https://fiksvegdata.atlas.vegvesen.no/

For utviklere

Tjenesten har et eksternt API som gir tilgang til status og driftmeldinger, tilgjengelig via REST og Websocket (push-meldinger).

Gå til OpenAPI-spesifikasjonen for mer informasjon.

OpenAPI-spesifikasjonen for tjenesten er tilgjengelig i tre ulike miljøer hos Statens vegvesen:

Miljø Formål Basis-URL
UTV Utvikling https://fiksvegdata-api.utv.atlas.vegvesen.no/
ATM Akseptansetesting https://fiksvegdata-api.test.atlas.vegvesen.no/
PROD Produksjon https://fiksvegdata-api.atlas.vegvesen.no/

OpenAPI

NVDB Fiksvegdata tilbyr en oppdatert OpenAPI-spesifikasjon som beskriver tilgjengelig funksjonalitet i tjenesten. Denne spesifikasjonen kan benyttes som grunnlag for å generere klientkode eller til å bygge integrasjoner mot tjenesten. Verktøy som for eksempel Orval eller OpenAPI-Generator kan benyttes til dette formålet.

Registrer ny feilmelding

Registrering av ny feilmelding kan gjøres gjennom to endepunkter. Vi skiller mellom registrering som anonym og som identifisert bruker. Ved å identifisere deg, får du notifikasjoner under behandling av feilen din.

Mønster

POST /api/v1/issues

Eksempel

curl -X 'POST' \
  'https://fiksvegdata-api.atlas.vegvesen.no/api/v1/issues' \
  -H 'accept: application/json' \
  -H 'Content-Type: application/json' \
  -d '{
  "subject": "Feil hastighet",
  "details": "Før svingen i krysset så viser det på kartet at det er 50km/t, men i virkeligheten er det 40km/t",
  "category": "MAP_ERROR",
  "location": {
    "northing": 652249.7055179164,
    "easting": 7736611.665507114,
    "municipalityNumber": 3002
  },
  "feature": {
    "nvdbId": 729541036,
    "version": 4
  },
  "roadSystemReference": "EV16 K S11D1 m1555"
}'

Hent feilmelding

Lesing av feilmeldinger er åpent for alle, men innholdet som returneres er tilgangsbegrenset. Vi operer hovedsaklig med to roller fixvgdat=saksbehandler og fixvgdat=administrator. Anonyme og autentiserte brukere får begrenset tilgang til innhold.

Mønster

GET /api/v1/issues/64600627-8441-1a6d-8184-417d11c20000

Eksempel vanlig bruker

{
  "id": "64600627-8441-1a6d-8184-417d11c20000",
  "submitter": null,
  "createdDate": "2022-11-04T07:13:46.422+00:00",
  "subject": "Feil emne",
  "details": "Dette er en feil",
  "category": "MAP_ERROR",
  "status": "NEW",
  "roadSystemReference": "EV6 S204D300 m673",
  "mapAuthorityReference": null,
  "feature": null,
  "isSubscribing": false,
  "location": {
    "municipality": "Alta",
    "county": "Troms og Finnmark",
    "northing": 7782663.3,
    "easting": 814092.6
  },
  "comments": [],
  "attachments": ["mitt-bilde.png"],
  "isMyIssue": false
}

Eksempel saksbehandler

{
  "id": "64600627-8441-1a6d-8184-417d11c20000",
  "submitter": "Olanor",
  "createdDate": "2022-11-04T07:13:46.422+00:00",
  "subject": "Feil emne",
  "details": "dette er en feil i alta",
  "category": "MAP_ERROR",
  "status": "NEW",
  "roadSystemReference": "EV6 S204D300 m673",
  "mapAuthorityReference": 123456,
  "feature": null,
  "isSubscribing": false,
  "location": {
    "municipality": "Alta",
    "county": "Troms og Finnmark",
    "northing": 7782663.3,
    "easting": 814092.6
  },
  "comments": [
    {
      "id": "64600b2d-8458-1634-8184-5c1fc00e0000",
      "content": "Dette er en kommentar",
      "createdBy": "Petter Pan",
      "internal": false
    }
  ],
  "attachments": ["mitt-bilde.png"],
  "isMyIssue": false
}

Laste opp vedlegg

Det er mulig å knytte en eller flere filer til en sak.

Mønster

POST /api/v1/issues/64600627-8441-1a6d-8184-417d11c20000/files/attach

Hent mine feilmeldinger

Feilmeldinger du sender inn mens du er innlogget, knyttes til deg som bruker. Da kan du hente kun dine egne saker.

Mønster

GET /api/v1/me/issues

Eksempel

{
  "issues": [
    {
      "id": "64601c53-83bb-1f27-8183-bbe2cdd80000",
      "createdDate": "2022-10-09T08:35:46.766+00:00",
      "subject": "min feil",
      "category": "MAP_ERROR",
      "status": "REJECTED",
      "location": {
        "municipality": "Molde",
        "county": "Møre og Romsdal",
        "northing": 6980466.1,
        "easting": 99764.423
      }
    }
  ]
}

Annet

Det finnes også mer funksjonalitet knyttet til API-et, blant annet for ansvarsfordeling og behandling av feilmeldinger. Full oversikt er tilgjengelig i OpenAPI-spesifikasjonen.

Sist oppdatert: