API-dokumentasjon

AUTENTISERING

Alle skrivekall krever header X-API-Key: <nøkkel>. Nøkkelen er knyttet til én 110-sentral. Hvis nøkkelen krever signatur, må du også sende X-Signature: sha256=<HMAC-SHA256 av rå body>.

Rate-limit: 60 forespørsler per minutt per nøkkel (svar 429 med Retry-After).

POST/api/v1/incidents

Opprett en hendelse. Idempotent på external_id per sentral — samme ID sendt flere ganger gir ingen dublett.

FELTER (JSON body)

EKSEMPEL

curl -X POST https://branninfo-admin-web.vercel.app/api/v1/incidents \
  -H "X-API-Key: <din-nøkkel>" \
  -H "Content-Type: application/json" \
  -d '{
    "external_id": "SAK-2026-001",
    "incident_type_id": "<uuid>",
    "municipality_id": "<uuid>",
    "severity": "major",
    "public_area": "Sentrum",
    "public_text": "Melding om brann i bygning.",
    "raw_lat": 62.47, "raw_lng": 6.15
  }'

SVAR

• 201 — opprettet: { "id": "…", "status": "created" }
• 200 — fantes fra før (idempotent): { "id": "…", "status": "exists" }
• 400 — ugyldig data
• 401 — ugyldig nøkkel eller signatur
• 429 — for mange forespørsler

HMAC-SIGNERING (hvis påkrevd)

# signatur = HMAC-SHA256(rå JSON-body, signeringshemmelighet)
SIG=$(printf '%s' "$BODY" | openssl dgst -sha256 -hmac "$SECRET" | sed 's/^.* //')
curl -X POST https://branninfo-admin-web.vercel.app/api/v1/incidents \
  -H "X-API-Key: $KEY" -H "X-Signature: sha256=$SIG" \
  -H "Content-Type: application/json" -d "$BODY"

GET/api/v1/health

Helse-sjekk, krever ikke autentisering.

HENDELSESTYPER (incident_type_id)