Hva er ninjs – og hvorfor det passer for moderne nyhetssystemer

Når jeg spør tidligere kollegaer om de fortsatt bruker IPTC-standard X, får jeg ofte som svar at ja de gjør de, men at de har tenkt å gå over til ninjs (News in JSON).

De er ikke alene om å tenke slik. Mange velger ninjs – IPTCs standard for å strukturere nyheter i JSON. Det er lett, lesbart og laget for utveksling.

Kort forklart: JSON for nyheter

ninjs står for News in JSON. Det er en standard utviklet av IPTC, organisasjonen bak blant annet NewsML-G2, NITF og SportsML. ninjs gir deg et ferdig rammeverk for hvordan nyhetsinnhold skal struktureres i JSON – med tittel, ingress, byline, publiseringstidspunkt og mer.

Standarden ble lansert i 2013, og har siden fått flere versjoner. Den nyeste – versjon 3.0 – ble godkjent i oktober 2024. Den innfører støtte for hendelser og planlagte saker, i tillegg til vanlige artikler, og benytter nå camelCase for bedre lesbarhet og API-støtte.

Hva brukes ninjs til?

ninjs brukes i API-er, publiseringssystemer og integrasjoner. Systemer som Superdesk bruker det som sitt foretrukne format for eksport og distribusjon. Når du publiserer en artikkel i Superdesk, sendes den som ninjs – gjerne via HTTP PUSH – til WordPress eller et annet system.

Her kan du lese en artikkel vi har skrevet om nettopp det å bruke Superdesk sammen med WordPress.

Du kan bruke ninjs internt, som mellomformat mellom systemer, eller som API-respons direkte ut til frontend. Det egner seg godt for nyhetssystemer, men også for pressemeldinger, datastrømmer og automatisert publisering.

Hva skiller ninjs fra NewsML-G2?

Begge formatene bygger på samme informasjonsarkitektur fra IPTC. Men der NewsML-G2 er XML-basert og strukturert for komplekse nyhetspakker, er ninjs lettere og mer rett på sak. Du får de viktigste feltene – i et format som er raskt å prosessere, lett å lese og enkelt å feilsøke.

Der NewsML-G2 krever omfattende schema-validering og egen håndtering av multimedieelementer, gir ninjs deg et ferdig format som kan brukes direkte i de fleste utviklingsmiljøer.

Er ninjs blitt ny standard?

Det kommer an på hvem du spør. Mange nyhetsbyråer og medier beholder standarden de allerede bruker, fordi det er dyrt og risikabelt å bytte. Men når nye systemer bygges, er ninjs et naturlig valg.

Det finnes støtte for ninjs i GraphQL, eksempelfiler på GitHub, og offisielle verktøy for validering og generering. I tillegg finnes det XSLT-konverteringer fra NewsML-G2 til ninjs – og omvendt – slik at formatene kan leve side om side.

Vår erfaring med ninjs i praksis

Jeg har brukt ninjs i systemer som distribuerer nyheter i sanntid. Siden lanseringen av ninjs har jeg laget konverteringer fra ninjs til XML, bygget publiseringspipeliner med validering og fallback, og testet løsninger som kobler ninjs til WordPress.

Som medlem av IPTC, har jeg også vært med i utviklingen av standarden – og kjenner både styrker og svakheter. Hos Inside Creative hjelper jeg deg gjerne med å bruke ninjs på en effektiv og robust måte – enten det er snakk om eksport, import, mellomlagring eller integrasjon.