Bruke queries i Utdanningsregister API

Utdanningsregisterets GraphQL API tilbyr queries for å hente data om utdanninger, organisasjoner og akkrediteringer.

Forutsetninger

Denne guiden forutsetter at du har gjennomført Kom i gang og forstår grunnleggende GraphQL-konsepter.

Oversikt over queries

Kategori	Beskrivelse
Organisasjoner	Hent universiteter, høyskoler og andre organisasjoner
Utdanningsspesifikasjoner	Beskrivelser av utdanninger (f.eks. "Bachelor i informatikk")
Utdanningsmuligheter	Utdanninger som tilbys av organisasjoner
Utdanningsinstanser	Konkrete gjennomføringer med tid og sted
Campus	Fysiske og digitale studiesteder
Akkreditering	Akkrediteringsinformasjon for organisasjoner og utdanninger
Kodeverk	Land, språk, nus

Datamodell

Les Datamodell for å forstå sammenhengen mellom spesifikasjoner, muligheter og instanser.

Grunnleggende eksempler

Disse eksemplene viser hvordan du henter data uten filtrering. For filtrerte søk, se Vanlige filtermønstre.

Hent organisasjoner

query HentOrganisasjoner {
  alleURegOrganisasjoner(first: 2) {
    nodes {
      id
      organisasjonskode
      originalnavn
      erAktiv
      sektor {
        kode
        navn
      }
    }
  }
}

Eksempel resultat:

{
  "data": {
    "alleURegOrganisasjoner": {
      "nodes": [
        {
          "id": "MTAxMDQ6MTUw",
          "organisasjonskode": "150",
          "originalnavn": "Norges idrettshøgskole",
          "erAktiv": true,
          "sektor": {
            "kode": "STATLIG",
            "navn": "Statlig sektor"
          }
        },
        {
          "id": "MTAxMDQ6MTg1",
          "organisasjonskode": "185",
          "originalnavn": "Universitetet i Oslo",
          "erAktiv": true,
          "sektor": {
            "kode": "STATLIG",
            "navn": "Statlig sektor"
          }
        }
      ]
    }
  }
}

Hent utdanningsspesifikasjoner

query HentUtdanningsspesifikasjoner {
  alleUtdanningsspesifikasjoner(first: 10) {
    nodes {
      id
      kode
      originalnavn
      nkr {
        kode
      }
      vekting {
        verdi
        vektingstype {
          kode
        }
      }
    }
  }
}

Hent utdanningsmuligheter

query HentUtdanningsmuligheter {
  alleUtdanningsmuligheter(first: 20) {
    nodes {
      id
      kode
      organisasjon {
        organisasjonskode
        originalnavn
      }
      utdanningsspesifikasjon {
        originalnavn
      }
    }
  }
}

Hent utdanningsinstanser

query HentUtdanningsinstanser {
  alleUtdanningsinstanser(first: 50) {
    nodes {
      id
      originalnavn
      periodekode
      termin {
        fraTermin {
          arstall
          kode
        }
        tilTermin {
          arstall
          kode
        }
      }
      utdanningsmulighet {
        kode
      }
    }
  }
}

Vanlige filtermønstre

API-et tilbyr to typer filtreringsqueries:

• *GittFilter - Kombinerer flere filterparametre (f.eks. utdanningsspesifikasjonerGittFilter)
• *Gitt<Felt> - Filtrerer på ett spesifikt felt (f.eks. uRegOrganisasjonerGittOrganisasjonskode)

Filtrer på spesifikt felt

Bruk *Gitt<Felt> for å filtrere på ett spesifikt felt:

query HentOrganisasjon {
  uRegOrganisasjonerGittOrganisasjonskode(organisasjonskoder: ["185"]) {
    id
    organisasjonskode
    originalnavn
    erAktiv
    sektor {
      kode
      navn
    }
  }
}

Eksempel resultat:

{
  "data": {
    "uRegOrganisasjonerGittOrganisasjonskode": {
      "id": "MTAxMDQ6MTg1",
      "organisasjonskode": "185",
      "originalnavn": "Universitetet i Oslo",
      "erAktiv": true,
      "sektor": {
        "kode": "STATLIG",
        "navn": "Statlig sektor"
      }
    }
  }
}

Filtrer utdanningsspesifikasjoner

Kombiner flere filtre for å finne spesifikke utdanninger:

query MasterprogrammerInformatikk {
  utdanningsspesifikasjonerGittFilter(
    filter: {
      nkrkode: ["7"]
      statuskode: ["AKTIV"]
      utdanningsnavn: "informatikk"
    }
    first: 20
  ) {
    nodes {
      id
      originalnavn
      vekting {
        verdi
        vektingstype {
          kode
        }
      }
    }
  }
}

Vanlige filtre:

• nkrkode: ["7"] - NKR-nivå (liste av strenger)
• statuskode: ["AKTIV"] - Status (liste av strenger)
• utdanningsnavn: "informatikk" - Fulltekstsøk i navn (string)
• kode: ["BINF", "MINF"] - Utdanningskoder (liste)

Filtrer utdanningsmuligheter

query AktiveUtdanningsmuligheter {
  utdanningsmuligheterGittFilter(
    filter: {
      statuskode: AKTIV
    }
    first: 20
  ) {
    nodes {
      id
      kode
      organisasjon {
        organisasjonskode
        originalnavn
      }
      utdanningsspesifikasjon {
        originalnavn
      }
    }
  }
}

Vanlige filtre:

• statuskode: AKTIV - Status (enum)
• kode: ["BINF", "MINF"] - Mulighetskoder (liste)
• utdanningsspesifikasjonsId: ["id1", "id2"] - Filtrer på spesifikke utdanninger

Filtrer utdanningsinstanser

query AktiveUtdanningsinstanser {
  utdanningsinstanserGittFilter(
    filter: {
      statuskode: AKTIV
    }
    first: 50
  ) {
    nodes {
      id
      originalnavn
      periodekode
      termin {
        fraTermin {
          arstall
          kode
        }
        tilTermin {
          arstall
          kode
        }
      }
      utdanningsmulighet {
        kode
      }
    }
  }
}

Vanlige filtre:

• statuskode: AKTIV - Status (enum)
• kode: ["BINF-1", "MINF-1"] - Instanskoder (liste)
• utdanningsmulighetId: ["id1"] - Filtrer på spesifikk mulighet