Skaffe tilgang til Utdanningsregister API
Utdanningsregisterets API krever autentisering via Maskinporten, Digitaliseringsdirektoratets løsning for sikker system-til-system autentisering.
Tilgjengelige scopes
Utdanningsregisteret tilbyr to scopes basert på ditt behov:
| Scope | Tilgang | Beskrivelse |
|---|---|---|
sikt:utdanningsregisteret/utdanning.read | Lesetilgang | Hent utdanningsdata via GraphQL queries |
sikt:utdanningsregisteret/utdanning.write | Lese- og skrivetilgang | Rapporter og oppdater utdanningsdata via GraphQL mutations |
Skaffe tilgang via Maskinporten
For å få tilgang til API-et må du:
- Opprett Maskinporten-integrasjon: Registrer en OAuth2-klient i Maskinportens selvbetjeningsportal
- Søk om tilgang til scope: Legg til ønsket scope i din integrasjon
- Hent access token: Generer JWT-basert token for API-kall
Komplett veiledning:
- Maskinporten: Kom i gang for API-konsumenter - steg-for-steg guide
- Maskinporten selvbetjeningsportal - administrer integrasjoner og scopes
- Maskinporten autentisering - teknisk oppsett og JWT-generering
Selvbetjeningsportaler:
- Test-miljø: https://sjolvbetjening.test.samarbeid.digdir.no/
- Produksjon: https://sjolvbetjening.samarbeid.digdir.no/
API-endepunkt
Når du har fått tilgang til scopet og hentet access token fra Maskinporten, kan du kalle API-et:
Test-miljø:
https://api-test.fsweb.no/graphql
Produksjon:
https://api.fsweb.no/graphql
Nødvendige headers:
Authorization: Bearer <access_token>
Feature-Flags: beta,experimental
Feature Flags
API-et krever Feature-Flags: beta,experimental header for alle forespørsler.