Gå til hovedinnhold

Tekniske grenser for FS APIene

På denne siden oppgir Sikt de tekniske grensene som gjelder for FS-APIene akkurat nå. De tekniske grensene er utfyllende informasjon til API-kontrakten. Når Sikt endrer en teknisk grense så varsler vi det etter frister og i kanaler som er gitt i API-kontrakten.

Merk at vi i henhold til API-kontrakten kan innføre akutte tiltak for å verne driften uten forhåndsvarsel.

Sist oppdatert: 20.07.2026

Tidsgrenser (time out)

Spørringer som overskrider tidsgrensen, avbrytes automatisk slik at ikke enkelte, tunge spørringer låser api-ressurser for andre brukere.

Vi har tidsbegrensninger på flere tjenestelag, og det er det laveste tjenestelaget som gjelder til enhver tid.

TjenestelagGrenseverdi
Supergraf59 sekunder
SIS-subgraf30 sekunder. Overskrides den, får du 504 Gateway timeout direkte mot subgrafen, og en generell GraphQL-feil via supergrafen.

Paginering

FS GraphQL API bruker cursor-basert, forward-only paginering (Relay-standard: first/after, last/before støttes ikke).

Paginering
InnstillingGrenseverdi
Standard for paginerte felt på query-rota100
Standard for paginerte felt på andre steder (nøstet)10
Maksimal sidestørrelse (hard grense)1000

Ber du om flere enn maks (f.eks. first: 5000), får du likevel maksimalt 1000 elementer. Merk at totalCount ikke viser totalt antall i databasen, men antall tilgjengelig fra gjeldende posisjon (maks 1000).

Rate- og kompleksitetsgrenser

For å holde APIet stabilt for alle konsumenter kan Sikt sette grenser for hvor komplekse, ressurskrevende eller hyppige spørringer kan være. Eksempelvis kan Sikt innføre tak på:

  • dybde eller bredde for spørringer
  • antall spørringer pr. tidsenhet
ikke innført pr. dags dato. Vi har planlagt å innføre rate-begrensning, men har ikke aktivert denne ennå. Konkrete verdier fylles ut når vi tar mekanismen i bruk.