Spesifikasjon for tjeneste- og hendelsesbeskrivelser (CPSV-AP-NO)
-
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.!
-
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?
-
@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. -
@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.
