Gå til hovedinnhold

Hva er GraphQL?

GraphQL er et spørrespråk som brukes for utveksle data med en server. Det som kjennetegner et GraphQL-API, er at du som konsument kan etterspørre akkurat de dataene du trenger. Dette skiller seg fra f.eks. REST-APIer der du må forholde deg til endepunkter med forhåndsdefinerte datasett.

Hvordan du kan hente og manipulere data er definert i GraphQL-skjemaet. Vårt GraphQL API støtter følgende operasjoner:

  • Spørringer: Gir deg mulighet til å hente data
  • Mutasjoner: Gir deg mulighet til å manipulere data

Dataene i et GraphQL-API er representert i et system av kanter og noder. En node representerer en type som kan inneholde data, mens kanter representerer relasjoner mellom nodene. Dette gjør GraphQL til et godt verktøy for å tilgjengeliggjøre store, komplekse datasystemer.

For eksempel: I FS GraphQL API finnes det en node StudentVedLarested med en kant mot noden ProgramStudierett. StudentVedLarested representerer data om studenten ved et gitt lærested. Kanten mot ProgramStudierett gir deg alle studierettene studenten har på studieprogrammer ved dette lærestedet. Noden ProgramStudierett har igjen en kant mot Studieprogram som viser hvilket studieprogram den enkelte programstudieretten gjelder.

Eksempel som viser noden StudentVedInstitusjon med kant mot ProgramStudierett og kant videre mot Studieprogram