API-pilot — Dokumentation

Inte publik self-service

Skolkoll publicerar inte ett lanserat publikt API i Wave 0. Det finns därför ingen publik endpointkatalog, inga öppna auth-flöden, inga rate-limit-garantier och inga kodexempel att starta integrationer från.

Kontoportalen kan visa API-nycklar endast för avtalade privata pilotfall. Nycklar skapas inte som self-service och ska inte tolkas som att API:t är ett publikt produktlöfte.

Så får du data i Wave 0

• Öppna CSV-nedladdningar är den publika maskinläsbara vägen.
• Öppen data beskriver källor, licens och kända begränsningar.
• API-roadmap beskriver vad som saknas innan ett publikt API kan lanseras.
• Behöver du återkommande datauttag kan du kontakta info@skolspegeln.se för att diskutera Data- eller Enterprise-leverans.

Privat pilot

En pilot är begränsad till ett avtalat användningsfall, ett tydligt databehov och separata villkor för volym, support, säkerhet och uppsägning. Pilotdokumentation delas direkt med deltagande organisationer och publiceras inte som allmän produktdokumentation.

Tak för organisationens API-nycklar

• Varje nyckel får göra högst 100 anrop per minut.
• Organisationens nycklar delar en månadskvot: 50 000 anrop per kalendermånad med Kommunlicens Premium och 10 000 med övriga paket, om inte avtalet anger ett annat tak.
• När 80 % av månadskvoten är förbrukad försöker vi mejla organisationens administratörer, högst en gång per månad och om personuppgiftsbiträdesavtalet tillåter det. Mejlet är en förvarning, inte en garanti; X-Quota-Remaining visar alltid hur mycket som återstår.
• När kvoten är slut svarar API:t 429 Monthly API quota exceeded tills kvoten nollställs den första dagen i nästa månad (UTC).