Test-API for NADAG innmelding

For at leverandører og andre interessenter skal kunne teste ut API-et, har vi satt opp en tjener med test-API-et, slik det så langt er definert og implementert, på https://test.ngu.no/api/nadag/innmelding/v1

OpenAPI-dokumentasjon er tilgjengelig på https://test.ngu.no/api/nadag/innmelding/openapi/v1, mens swagger-UI for tjenester er tilgjengelig på https://test.ngu.no/api/openapi-ui/. I "Explore"-feltet øverst, fyll inn /api/nadag/innmelding/openapi/v1 for innmelding.

Funksjonalitet i test-API-et

Test-API-et er satt opp med krav til autentisering via maskinporten og innveksling av autorisasjons-token i eget endepunkt hos NGU. Endepunktet er satt opp her: https://test.ngu.no/api/auth/token. Hvis en ønsker bruker Swagger UI så kan en dermed velge Authorize og skrive token som er generert av dette endepunktet.

Validering av grunnundersøkelser og underliggende borehull, borehullsundersøkelser osv. er implementert.

>> Oversikt over implementerte valideringsregler

Historikken under over endringer i test-API-et, oppdateres etterhvert som det slippes nye versjoner.

Slipp-historikk

2025-06-06: Oppdatert versjon, men noen endringer og bedre rapportering av feilmeldinger.

  • GeotekniskBorehull i sti er erstattet med undersPkt

  • HTTP-status blir riktigere, f.eks. 400 Bad Request for ugyldig input

  • Mer informativ feilmelding i responsen

2025-05-27: Andre versjon av test-API-et er sluppet.

  • full autentisering

  • lagring av innmeldte GU-er

  • validering av GU-er og underliggende borehull, borehullsundersøkelser osv.

2025-02-04: Første versjon av test-API-et er sluppet.

  • ingen autentisering

  • ingen lagring av innmeldte GU-er

  • delvis validering av GU-er og underliggende borehull, borehullsundersøkelser osv.

    • sjekk av en del påkrevde felt

    • geometri må være innenfor fastlands-Norge

    • borehull må være innen grunnundersøkelsens område

    • borehullundersøkelser må være i nærheten av borehullet