Cheat sheet for Swagger-løsningen vår

Denne artikkelen er under arbeid. Foreslå gjerne endringer og forbedringer

Enkelte av GET-forspørslene i Greps Swagger-løsning er ikke like intuitive når det kommer til hvilke verdier kan legges inn i feltene {type}, {kode}, {format} osv. Derfor har vi nedenfor listet opp alle typer GET-forespørsler med et hint om hva som er forventet verdi for de enkelte.

Legg merke til forskjellen på forventet {type} i en URL-request, og "grep-type" som attributt i alle forekomster.

• NOR1211 forekommer i arrayet http://data.udir.no/kl06/v201906/fagkoder (plur.)
• NOR1211 er av "grep-type": "http://psi.udir.no/ontologi/kl06/fagkode" (sing.)

Verdi for {type} i GET-requestene nedenfor, er grep-typen i plural form, f.eks "fagkoder". En forespørsel etter f.eks. /kl06/v201906/fagkoder, returnerer et array av alle fagkoder i Grep, men den samme forespørselen etterfulgt av f.eks. /NOR1211, gjør altså et oppslag på den gitte forekomsten av grep-typen "fagkode".

Se også liste-over-alle-typene-i-Grep

TODO: Skrive mer om {filter} og {format}

Lenke til Swagger-løsningen:

• UI: https://data.udir.no/kl06/swagger/ui/
• Definisjoner:
  • v201906: https://data.udir.no/swagger/docs/201906