For redaksjoner og CMS-leverandører

Redaksjonsleveransen

Politipuls leverer politihendelser, trafikkmeldinger og ferjemeldinger i samme feltmodell som nyhetsbyråene: ninjs, med NTBs emnekoder og IPTC Media Topics. Et CMS med byråinntak kan legge Politipuls inn ved siden av NTB. I tillegg har hvert element koordinater med presisjon, en eksplisitt rettelsesmodell og tidsstempler som gjør hastigheten målbar.

Schema
https://politipuls.no/utviklere/leveranse/ninjs-politipuls.schema.json
Profil
politipuls-ninjs/2
Standard
IPTC ninjs 2.2 med utvidelser fra TT og NTB

Filer

Schemaet er kontrakten. Vokabularene og eksemplene er de samme filene som Politipuls bygger og tester mot. Eksemplene er bygget fra ekte hendelser 1. november 2026.

Pull-API og strøm

Elementene hentes fra https://politipuls.no/api/v1. Beskrivelsen eropenapi.yaml (OpenAPI 3.1).

Feltene

Kjernefeltene har navn og typer fra ninjs 2.2. Utvidelsene bruker navnene TT og NTB bruker der de finnes. Schemaet avviser felt det ikke kjenner.

uri
Stabil identitet, lik for alle versjoner: politipuls:hendelse/<id>, politipuls:trafikk/<id> eller politipuls:ferje/<id>.
version
Stigende heltall som streng. Mottakeren beholder høyeste versjon per uri.
firstcreated, versioncreated
Kildens tid for første versjon og for denne versjonen.
pubstatus, signal
Status og hva versjonen er. Se rettelsesmodellen.
replacing, replacedby, revisions
Versjons-URI-er bakover og fremover, og hele historikken til og med denne versjonen.
language
Språket i kildens tekst (nb). Et automatisk utkast på nynorsk ligger i samme element med role draft-nn, ikke som eget element.
urgency, newsvalue
ninjs urgency 1 til 9 og NTBs nyhetsverdi 1 til 6, fra nyhetsvekten.
headlines, descriptions, bodies
Tittel, ingress og brødtekst. Brødteksten kommer både som text/html og text/plain, med kreditering til slutt. Første element er alltid kildens tekst (role main, summary for ingress); et automatisk utkast følger etter med role draft (bokmål) og draft-nn (nynorsk).
subjects
Politipuls-kategori, NTB-emnekode (subj:) og IPTC Media Topic (medtop:).
places
Kommune med Wikidata-QID, kommunenummer, fylke, politidistrikt, GeoJSON-geometri og presisjon.
service, genres
Én service-kode per kilde, og NTB-sjanger: Robottekst, Notiser (automatisk utkast) eller Rettelser.
altids
POLITIPULS-ID og DOC-ID alltid; politiets tråd- og meldings-ID for politihendelser.
infosources, copyrightholder, copyrightnotice, rightsinfo
Kilden og Politipuls som distributør, med NLOD-kreditering.
ednote, ednotes
Redaksjonelle merknader. is_publishable false betyr at innholdet ikke skal publiseres som det er. Et holdt automatisk utkast gir en merknad med koden fra sperren.
associations
Bilder som renditions: politiets bilde eller nærmeste trafikkamera.
timestamps
source_published, first_observed og delivered. Grunnlaget for målt hastighet. null betyr ukjent eller ikke levert.

Identitet, versjoner og rettelser

En politihendelse får én ny versjon for hver ny melding i tråden og for hver gang politiet redigerer en melding. Hver versjon har versjons-URI-en <uri>/versjon/<version>. Levering er minst én gang; uri og version avgjør hva som er nyest.

ID-en i uri, versjons-URI og DOC-ID inneholder bare A–Z, a–z, 0–9,_ og -. Alle andre tegn, også _, kodes som _ og to store heksadesimale sifre per UTF-8-byte: NPRA_HBT_01-11-2026.162057 blirNPRA_5FHBT_5F01-11-2026_2E162057. Politiets ID-er er uendret.

Hent en politihendelse

signalpubstatusNår
newusableVersjon 1. Ingen replacing.
updateusableNy melding i tråden. replacing peker på forrige versjon, som får pubstatus: replaced og replacedby.
correctionusablePolitiet har redigert en melding (isEdited). Sjangeren Rettelser og en ednotes-merknad med koden rettelse er påkrevd.
canceledcanceledTrukket tilbake. Fjern overalt.

Automatisk utkast

Politiets tekst leveres straks og venter aldri på notisgeneratoren. Når generatorens utkast for akkurat den teksten er ferdig, kommer det som neste versjon med signal: update og samme uri, i webhook, Slack, Teams, strømmen, feedene og /ninjs. versioncreated er da tiden utkastet ble en versjon, og timestamps.source_published er kildetiden det bygger på.

Profil 2 (politipuls-ninjs/2): endringer fra profil 1

altids

POLITIPULS-ID
Politipuls sin ID for hendelsen eller meldingen, ukodet. I uri og DOC-ID står den kodet til A–Z, a–z, 0–9, _ og -.
POLITIET-THREAD-ID
Politiloggens tråd-ID. Bare politihendelser.
POLITIET-MESSAGE-ID
Politiloggens ID for meldingen denne versjonen gjelder. Bare politihendelser.
DOC-ID
Versjonens dokument-ID på NTB-form: PP<kodet POLITIPULS-ID>_NN, der NN er versjonen med minst to sifre.

Avviksvarsler (egen kontrakt, ikke ninjs)

Et abonnement kan i tillegg be om avviksvarsler (valget «Send også avviksvarsler», standard av). Varselet leveres i samme kanal og med samme signering som hendelsene, men er ikke et ninjs-element og følger ikke schemaet over. Mottakere som bare forventer hendelser skal ikke slå det på.

Feeder

Hvert CMS med feed-importer kan legge Politipuls inn uten ny opplæring. Samme utvalg finnes i fire formater: Atom 1.0, RSS 2.0, JSON Feed 1.1 og en ninjs-samling, som er en JSON-array av elementer etter schemaet over. Kommune-, distrikt- og kategorisidene peker på feedene sine med <link rel="alternate">.

UtvalgAdresseEksempel
Politi, trafikk og ferje i en kommune. Kommunenummeret er det firesifrede./feed/kommune/<kommunenr>.<format>Oslo: .atom .rss .json .ninjs.json
Politimeldinger i et politidistrikt. Slugen er den samme som i /distrikt/<slug>/./feed/distrikt/<slug>.<format>Oslo politidistrikt: .atom .rss .json .ninjs.json
Politimeldinger i en kategori. Slugen er den samme som i /kategori/<slug>/./feed/kategori/<slug>.<format>Brann: .atom .rss .json .ninjs.json
Alt fra én kilde, i hele landet./feed/kilde/<pp-politi|pp-trafikk|pp-ferje>.<format>Politi: .atom .rss .json .ninjs.json
.atom
— Atom 1.0, application/atom+xml.
.rss
— RSS 2.0, application/rss+xml.
.json
— JSON Feed 1.1, application/feed+json.
.ninjs.json
— ninjs, application/json.

Hva et feed-element er

Emner

Hvert politielement har kategorien som politipuls:kategori/<slug>, NTBs emnekoder somsubj:<kode> og IPTC Media Topics som medtop:<kode>. Trafikk som er en ulykke får trafikkulykkekodene i stedet. Narkotika, Drap, Skred og Flom er Politiloggen-kategorier som Politipuls i dag viser som Andre hendelser; mappingen står klar.

KategoriNTB-emnekodeMedia Topic
Trafikk
02003000 Politi
Ulykke: 03010001 Trafikkulykker
20000133 politi
20000341 veitransport
Ulykke: 20000147 trafikkulykker
Brann
03004000 Brann
20000150 brann
Ulykke
03000000 Ulykker og naturkatastrofer
20000139 ulykker
Voldshendelse
02001006 Vold
20000084 vold
Tyveri
02001003 Tyveri og innbrudd
20000104 tyveri og innbrudd
Innbrudd
02001003 Tyveri og innbrudd
20000104 tyveri og innbrudd
Ro og orden
02003000 Politi
20000133 politi
Skadeverk
02000000 Kriminalitet og rettsvesen
20001285 hærverk
Andre hendelser
02003000 Politi
20000133 politi
Savnet
03012000 Nødhjelp
02003000 Politi
20000132 savnet person
Redning
03012000 Nødhjelp
02003000 Politi
20000168 katastrofeinnsats
Dyr
02003000 Politi
20000500 dyr
Vær
17000000 Vær
03007000 Ekstremvær
17000000 vær
20000157 ekstremvær
Arrangement
02003000 Politi
20000133 politi
Sjø
03000000 Ulykker og naturkatastrofer
20000145 maritime ulykker
Narkotika
02001004 Narkotika
20000095 narkotikalovbrudd
Drap
02001001 Drap
20000099 drap
Skred
17000000 Vær
03007000 Ekstremvær
20000155 ras
Flom
03005000 Flom
17000000 Vær
20000154 flom

Service-koder

pp-politi
Politiloggen. Kreditering: Politiet. Navnerom politipuls:hendelse/.
pp-trafikk
Statens vegvesen, trafikkmeldinger (DATEX II). Kreditering: Statens vegvesen. Navnerom politipuls:trafikk/.
pp-ferje
Entur, avviksmeldinger (SIRI-SX). Kreditering: Entur AS. Navnerom politipuls:ferje/.

Hast

Vekt 3: urgency 2, newsvalue 2
Toppsak med siste melding under seks timer gammel, eller stengt hovedveg etter uplanlagt hendelse.
Vekt 2: urgency 4, newsvalue 3
Sak, pågående hendelse eller uplanlagt hendelse som påvirker trafikken.
Vekt 1: urgency 6, newsvalue 5
Notis og planlagte forhold.

Steder og presisjon

places[] følger NTB: uri er Wikidata-entiteten for kommunen og literal er QID-en.county-dist og state-prov er kommune og fylke, med nummer i county-dist-id ogstate-prov-id. Det NTB ikke har: geojson med punkt eller linje i WGS 84 ogprecision, som sier hva koordinatene faktisk angir. Kommunevokabularet dekker alle357 kommuner.

precisionRangBetydning
exact6Punkt (historisk). Eldre punktetikett fra før klassene ble delt opp. Leses som et punkt.
named_point6Navngitt punkt. Punkt for et navngitt sted i kildeteksten, for eksempel en kai, et kjøpesenter eller en bru.
address6Adresse. Punkt for en adresse i kildeteksten.
street4Gate. Representativt punkt på en gate. Hendelsen kan ligge hvor som helst langs gaten.
road_segment3Vegstrekning. Punkt eller linje på en vegstrekning, ikke et bestemt sted på den.
area2Område. Representativt punkt for et område, tettsted eller kommune som kildeteksten nevner.
municipality1Kommune. Kommunens representative punkt. Sier bare hvilken kommune hendelsen gjelder.
unknown0Ukjent. Intern klasse. Leveres ikke; stedet sendes uten geojson og precision.

Eksempel: rettelse i en politihendelse

Brann i Haram 31. oktober 2026. Versjon 6 er politiets redigering av den andre meldingen; versjon 2 til 5 er oppfølginger. Eksemplet er hentet fra hendelsen på Politipuls.

Vis hele elementet
{
  "uri": "politipuls:hendelse/261kzv",
  "standard": {
    "name": "ninjs",
    "version": "2.2",
    "schema": "https://politipuls.no/utviklere/leveranse/ninjs-politipuls.schema.json"
  },
  "profile": "politipuls-ninjs/2",
  "type": "text",
  "representationtype": "full",
  "version": "6",
  "firstcreated": "2026-10-31T20:54:44.976Z",
  "versioncreated": "2026-10-31T21:12:12.387Z",
  "pubstatus": "usable",
  "signal": "correction",
  "replacing": "politipuls:hendelse/261kzv/versjon/5",
  "revisions": [
    {
      "version": "1",
      "uri": "politipuls:hendelse/261kzv/versjon/1",
      "versioncreated": "2026-10-31T20:54:44.976Z",
      "signal": "new",
      "pubstatus": "replaced"
    },
    {
      "version": "2",
      "uri": "politipuls:hendelse/261kzv/versjon/2",
      "versioncreated": "2026-10-31T20:55:06.568Z",
      "signal": "update",
      "pubstatus": "replaced"
    },
    {
      "version": "3",
      "uri": "politipuls:hendelse/261kzv/versjon/3",
      "versioncreated": "2026-10-31T20:59:01.684Z",
      "signal": "update",
      "pubstatus": "replaced"
    },
    {
      "version": "4",
      "uri": "politipuls:hendelse/261kzv/versjon/4",
      "versioncreated": "2026-10-31T20:59:32.093Z",
      "signal": "update",
      "pubstatus": "replaced"
    },
    {
      "version": "5",
      "uri": "politipuls:hendelse/261kzv/versjon/5",
      "versioncreated": "2026-10-31T21:01:54.969Z",
      "signal": "update",
      "pubstatus": "replaced"
    },
    {
      "version": "6",
      "uri": "politipuls:hendelse/261kzv/versjon/6",
      "versioncreated": "2026-10-31T21:12:12.387Z",
      "signal": "correction",
      "pubstatus": "usable"
    }
  ],
  "language": "nb",
  "urgency": 2,
  "newsvalue": 2,
  "slugline": "brann-haram",
  "located": "Haram",
  "headlines": [
    {
      "role": "main",
      "contenttype": "text/plain",
      "value": "Brann i et lokale. Nødetater på veg til stedet."
    }
  ],
  "descriptions": [
    {
      "role": "summary",
      "contenttype": "text/plain",
      "value": "Det skal ha vært et arrangement på stedet."
    }
  ],
  "bodies": [
    {
      "role": "main",
      "contenttype": "text/html",
      "value": "<p><time datetime=\"2026-10-31T20:54:44.976Z\">21:54</time> Brann i et lokale. Nødetater på veg til stedet.</p><p><time datetime=\"2026-10-31T20:55:06.568Z\">21:55</time> Det skal ha vært et arrangement på stedet. <em>(Redigert av politiet kl. 22:12.)</em></p><p><time datetime=\"2026-10-31T20:59:01.684Z\">21:59</time> Skal være overtent i flere etasjer.</p><p><time datetime=\"2026-10-31T20:59:32.093Z\">21:59</time> Pr nå ukjent om der er spredningsfare.</p><p><time datetime=\"2026-10-31T21:01:54.969Z\">22:01</time> Rettelse: Brannen skal være i en enebolig.</p><p class=\"kilde\">Kilde: Politiet, Politiloggen (NLOD 2.0). Distribuert av Politipuls.</p>"
    },
    {
      "role": "main",
      "contenttype": "text/plain",
      "value": "21:54 Brann i et lokale. Nødetater på veg til stedet.\n\n21:55 Det skal ha vært et arrangement på stedet. (Redigert av politiet kl. 22:12.)\n\n21:59 Skal være overtent i flere etasjer.\n\n21:59 Pr nå ukjent om der er spredningsfare.\n\n22:01 Rettelse: Brannen skal være i en enebolig.\n\nKilde: Politiet, Politiloggen (NLOD 2.0). Distribuert av Politipuls."
    }
  ],
  "subjects": [
    {
      "name": "Brann",
      "uri": "politipuls:kategori/brann"
    },
    {
      "name": "Brann",
      "uri": "subj:03004000"
    },
    {
      "name": "brann",
      "uri": "medtop:20000150"
    }
  ],
  "places": [
    {
      "name": "Søvika, Haram",
      "uri": "http://www.wikidata.org/entity/Q499575",
      "literal": "Q499575",
      "county-dist": "Haram",
      "county-dist-id": "1580",
      "state-prov": "Møre og Romsdal",
      "state-prov-id": "15",
      "police-district": "Møre og Romsdal politidistrikt",
      "geojson": {
        "type": "Point",
        "coordinates": [
          6.143767,
          62.718248
        ]
      },
      "precision": "area"
    }
  ],
  "service": [
    {
      "code": "pp-politi",
      "name": "Politipuls Politi"
    }
  ],
  "genres": [
    {
      "name": "Robottekst",
      "uri": "politipuls:sjanger/robottekst"
    },
    {
      "name": "Rettelser",
      "uri": "politipuls:sjanger/rettelser"
    }
  ],
  "altids": [
    {
      "role": "POLITIPULS-ID",
      "value": "261kzv"
    },
    {
      "role": "POLITIET-THREAD-ID",
      "value": "261kzv"
    },
    {
      "role": "POLITIET-MESSAGE-ID",
      "value": "261kzv-1"
    },
    {
      "role": "DOC-ID",
      "value": "PP261kzv_06"
    }
  ],
  "infosources": [
    {
      "name": "Politiet",
      "role": "source",
      "uri": "https://www.politiet.no/politiloggen/"
    },
    {
      "name": "Politipuls",
      "role": "distributor",
      "uri": "https://politipuls.no/hendelse/261kzv/"
    }
  ],
  "copyrightholder": "Politiet",
  "copyrightnotice": "Inneholder data under Norsk lisens for offentlige data (NLOD 2.0) tilgjengeliggjort av Politiet.",
  "usageterms": "Gjenbruk krever kreditering av Politiet som kilde. Politipuls er en uavhengig tjeneste og er ikke tilknyttet Politiet.",
  "rightsinfo": {
    "linkedrights": "https://data.norge.no/nlod/no/2.0"
  },
  "ednote": "Rettelse: Politiet redigerte kl. 22:12 meldingen som ble publisert kl. 21:55. Teksten i denne versjonen erstatter den tidligere.",
  "ednotes": [
    {
      "code": "rettelse",
      "text": "Politiet redigerte kl. 22:12 meldingen som ble publisert kl. 21:55. Teksten i denne versjonen erstatter den tidligere.",
      "is_publishable": true
    }
  ],
  "timestamps": {
    "source_published": "2026-10-31T21:12:12.387Z",
    "first_observed": null,
    "delivered": null
  }
}

Kilde og kreditering