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://110loggen.no/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)

Signerte forespørsler må inneholde et felt ts (unix-sekunder) i body-en. Serveren avviser tidsstempel som er mer enn 5 minutter unna nåtid, og hver signatur kan kun brukes én gang (replay-beskyttelse). Bruk derfor ferskt ts per forespørsel — det gir også en unik signatur ved ellers identiske kall.

# body må inkludere ts (unix-sekunder); signatur = HMAC-SHA256(rå JSON-body, hemmelighet)
BODY='{"external_id":"SAK-1","incident_type_id":"…","municipality_id":"…","ts":'$(date +%s)'}'
SIG=$(printf '%s' "$BODY" | openssl dgst -sha256 -hmac "$SECRET" | sed 's/^.* //')
curl -X POST https://110loggen.no/api/v1/incidents \
  -H "X-API-Key: $KEY" -H "X-Signature: sha256=$SIG" \
  -H "Content-Type: application/json" -d "$BODY"

PATCH/api/v1/incidents/:external_id

Oppdater en hendelse. Body: update_text, update_press_text, severity, public_area, is_significant, type (f.eks. correction for rettelse). Legger en ny linje i tidslinjen.

POST/api/v1/incidents/:external_id/close

Avslutt en hendelse. Body: summary_text, summary_press_text. Idempotent — allerede avsluttet gir 200.

GET/api/v1/health

Helse-sjekk, krever ikke autentisering.

GET/api/v1/openapi.json

Maskinlesbar OpenAPI 3.1-spesifikasjon for hele inntaks-API-et. Importer i Postman, Insomnia eller Swagger, eller generer klientkode. Krever ikke autentisering.

https://110loggen.no/api/v1/openapi.json

HENDELSESTYPER (incident_type_id)