API-nøkler i Grep

For English, see API keys

Fra og med høsten 2026 innfører Utdanningsdirektoratet API-nøkler for tilgang til Grep-data (REST, ikke SPARQL). Dette gjøres for å sikre stabil drift, gi bedre innsikt i bruksmønstre og forenkle teknisk støtte til våre brukere.

Se tidsplan lenger nede på denne siden

Slik skaffer du API-nøkkel

Alle brukere, av REST-APIet, må registrere seg og generere en nøkkel via vår portal:

👉 Portal for API-håndtering (Azure API Management)

Fremgangsmåte:

1. Logg inn eller registrer en ny bruker i portalen.
2. Velg produktet "Ubegrenset tilgang" (Vi kommer bare til å ha ett "produkt").
3. Opprett et abonnement ("Subscription"), og skriv gjerne firmanavn/navn på poduktet ditt e.l.
4. Du vil få tildelt en Primary Key og en Secondary Key (begge kan brukes) etter en manuell godkjenning hos oss.

Implementering

Nøkkelen skal inkluderes som en HTTP-header i alle forespørsler.

• Header-navn: x-api-key
• Verdi: din_api_nøkkel_her

Eksempel (REST):

GET https://data.udir.no/kl06/v201906/aarstrinn/aarstrinn1
Header: x-api-key: 123456789abcdef...

---

Tidsplan for innføring

Vi følger en trinnvis plan med overgangsperiode i sommer for å sikre at alle brukere rekker å legge om sine systemer:

Dato	Fase	Effekt
1. juni 2026	Lansering	API-nøkler blir tilgjengelige. Bruk er valgfritt, men anbefales sterkt.
3. august 2026	Varsling	Direkte oppfølging for å fange opp og identifiserte storkonsumenter som fortsatt kjører anonymt.
1. september 2026	Håndheving	Anonyme kall (uten nøkkel) blir begrenset via Rate Limiting (typisk (og ca.) 100/60 sek. eller 1,6 pr sek.).

Hvorfor innfører vi dette?

• Bedre støtte: Vi kan identifisere hvem som sender forespørselen og gi målrettet hjelp ved feil.
• Stabilitet: Vi kan begrense (throttle) trafikk fra enkeltaktører som utilsiktet overbelaster tjenesten.
• Sikkerhet: Beskyttelse mot misbruk og sikring av tjenestekvalitet for alle.

---

Vår ref: GREPF-2653 og GREPF-2838)