Autentisering

Graveinfo API bruker Bearer-token-autentisering med API-nøkler. Her er alt du trenger å vite.

Slik bruker du nøkkelen

Send nøkkelen i Authorization-headeren som et Bearer-token:

http

GET /api/v1/organizations/search?q=Hafslund HTTP/1.1
Host: graveinfo.no
Authorization: Bearer gv_live_a1b2c3d4e5f6...

Nøkkelen begynner alltid med gv_live_ etterfulgt av 64 hex-tegn (72 tegn totalt).

Hvem eier nøkkelen

En nøkkel tilhører organisasjonen eller entreprenørprofilen den ble opprettet på, og alle kall skjer på dens vegne. En administrator oppretter nøkkelen under Dashboard → API-nøkler: ledningseiere på organisasjonen, entreprenører på entreprenørprofilen. Er virksomheten begge deler (samme organisasjonsnummer), dekker én nøkkel både gravemelding- og innboks-endepunktene. Bruker du en leverandør som integrerer på dine vegne, er det du som oppretter nøkkelen og gir den til leverandøren.

Scopes

Når du oppretter en nøkkel velger du hvilke tilganger (scopes) den skal ha. Endepunkter som krever scope svarer 403 når nøkkelen mangler det. Søk og kommunedekning krever ikke scope. En nøkkel på en organisasjon (ledningseier) kan ha alle fire scopes; en nøkkel på en entreprenørprofil kan bare ha de to gravemeldinger-scopene.

gravemeldinger:readLes egne gravemeldinger: GET /gravemeldinger og GET /gravemeldinger/{id}.

gravemeldinger:writeOpprett og send gravemeldinger: POST /gravemeldinger og POST /gravemeldinger/{id}/send.

innboks:readLes mottatte gravemeldinger (for ledningseiere): GET /innboks.

innboks:writeSvar på mottatte gravemeldinger: POST /innboks/{recipientId}/svar.

Anonym tilgang

Organisasjonssøket kan brukes uten API-nøkkel, med lavere rate limit. Send kallet uten Authorization-header. Alle andre endepunkter krever nøkkel.

Søk uten nøkkel

20 kall/minutt

Søk med API-nøkkel

100 kall/minutt

Rate limit per endepunkt

Grensene gjelder per nøkkel og per minutt. Ved overskridelse svarer API-et 429. Det sendes ingen X-RateLimit-headere; innboks-endepunktene sender Retry-After.

GET /organizations/search100 (20 uten nøkkel, per IP)

GET /coverageingen grense

GET /gravemeldinger60

POST /gravemeldinger10

GET /gravemeldinger/{id}ingen grense

POST /gravemeldinger/{id}/send5

GET /innboks60

POST /innboks/{recipientId}/svar30

Feilsvar

Autentiseringsfeil returnerer HTTP 401 med følgende struktur:

json

{
  "error": {
    "code": "INVALID_API_KEY",
    "message": "Missing or invalid Authorization header"
  }
}

Rate limit-feil returnerer HTTP 429:

json

{
  "error": {
    "code": "RATE_LIMIT_EXCEEDED",
    "message": "Too many requests. Try again later."
  }
}

Feilkoden i error.code varierer mellom endepunktgruppene for 401 (INVALID_API_KEY eller UNAUTHORIZED) og 429 (RATE_LIMIT_EXCEEDED eller RATE_LIMIT). Sjekk HTTP-statusen for disse to tilfellene.

401Manglende, ugyldig, tilbakekalt eller utløpt API-nøkkel.

403Nøkkelen mangler scope, eller er ikke knyttet til en entreprenørprofil (MISSING_CONTRACTOR) eller organisasjon (MISSING_ORGANIZATION).

429Rate limit overskredet. Vent til neste minutt.

Best practices

✓Lagre nøkkelen i en miljøvariabel (.env), aldri hardkodet i kildekoden.
✓Bruk én nøkkel per miljø (utvikling, staging, produksjon).
✓Revokér nøkler som ikke lenger er i bruk under Dashboard → API-nøkler.
✓Sett en utløpsdato på nøkler som brukes i kortvarige prosjekter.
✓Logg API-kall på din side slik at du raskt oppdager uvanlig bruk.

Klar til å opprette din første nøkkel?

Gå til API-nøkler →