Spesifikasjon for tjeneste- og hendelsesbeskrivelser (CPSV-AP-NO)

Jim J. Yang

V.1.0 av Spesifikasjon for tjeneste- og hendelsesbeskrivelser (CPSV-AP-NO) er nå ferdig publisert, https://data.norge.no/specification/cpsv-ap-no.

Spesifikasjonen skal legge til rette for en felles måte å beskrive tjenester og hendelser og en felles måte å utveksle beskrivelsene. Spesifikasjonen muliggjør også maskinell tilgang til beskrivelser av tjenester og hendelser.

Vi oppfordrer alle til å ta i bruk spesifikasjonen!

Bruk gjerne denne tråden til å diskutere/erfaringsutveksle/osv.!

? Frakoblet

Hei,

Noen som vet om en swagger løsning for API som gir spesifikasjon for CPSV-AP og DCAT? Vil mappe opp metadata vi har mot avlevering iht standardene og lage et oversettelseslag fra våre APIer slik at våre kunder kan beskrive datasett og tjenester i riktig format. Har felles datakatalog API for registrering som evt kan brukes?

livar.bergheim

@christian-butenschon Kort fortalt så har Felles datakatalog mulighet for å høste inn kataloger, for eksempel DCAT-AP-NO. Det finnes et Python-bibliotek man kan bruke for å generere DCAT-AP-NO. Skal be en kollega svare mer utfyllende på dette.

Hva legger du i «swagger løsning»?
Er det noe spesielt verktøy eller funksjonalitet i swagger-sfæren du tenker på?

For andre som leser tråden:
Swagger, eller Open API, er en spesifikasjon for å beskrive API-er. CPSV-AP og DCAT er tilsvarende standarder for andre området.

? Frakoblet

@livar-bergheim Takk for svar. Bakgrunnen for spørsmålet er at vi har en teknologiplattform hvor bl annet en rekke metadata for prosesser og systemer kan beskrives på veldig detaljert nivå. Vi har samtidig API endepunkter på de aller fleste felt. Vi ønsker å mappe opp feltene og APIet mot DCAT, CPSV-AP og W3Cs Data Privacy Vocabulary (DPV). Dette vil gjøre det enkelt for våre kunder å utveksle opplysninger samt publisere tjenester og datasett. Jeg er selv ikke en teknikker, men er ute å sonderer terrenget for utviklerne. I og med at felles datakatalog skal legge til rette for datadeling og publisering av informasjon så tenker jeg det kan være et godt utgangspunkt for å få en god oversikt over hvilke felt som er obligatoriske, anbefalte og frivillige etc etc og bruke det som utgangspunkt for å mappe opp vårt API.

Vi har f eks flere hundre fagsystemer og prosesser dokumentert i vår løsning hvor vi gjerne skulle presentert innholdet iht DCAT/CPSV.

Per Schrader

Hei @livar-bergheim
Fiskeridirektoratet arbeider i disse dag med å etablere en automatisert distribusjon av datasett- og api-metadata til data.norge, med Swagger som kilde. Jeg jobber som informasjonsforvalter, og har kollegaer som vil bidra med teknisk kompetanse i dette forløpet. Jeg forsøker nå å avdekke om det finnes tekniske løsninger her allerede, da jeg antar vi ikke er eneste med dette behovet.

I første omgang ønsker vi bare å få etablerte en konvertering av metadata fra swagger til DCAT-AP-NO. Vi har testet ut en løsningen skrevet i Python som ligger på github, men denne støtter ikke DCAT-AP-NO v.3 og er ikke forvaltet siden 2022. Vi har avventet å ta denne i bruk da den inneholder noen formatfeil, samt at vi ønsker å sjekke ut om det finnes andre løsninger her.

Vårt spørsmål er derfor om Digdir har planer om å etablere og forvalte en slik teknologi?

For andre som leser tråden: Ta gjerne kontakt, dersom de har erfaringer å dele her.

livar.bergheim

@Per-Schrader Jeg skal plukke opp tråden over nyttår. Blant annet sjekke planene for å oppdatere biblioteket for å konvertere fra Swagger/Open API specification (OAS) til DCAT. Tillater meg å nevne kollega @terje-sylvarnes som jeg tror er interessert i denne tråden.