Public API & webhooks — byg dine egne integrationer
Skolens IT-afdeling eller eksterne leverandører kan bygge integrationer mod Erhverv.ai via REST-API og webhooks. Per-skole API-nøgler, HMAC-signerede webhooks og fuld OpenAPI 3.1-dokumentation.
Per-skole API-nøgler
API-nøgler i format sk_live_*** udstedes pr. skole. Scope kan begrænses (read-only, kursistdata, ingen følsom).
REST endpoints
Kursister, hold, karakterer, fraværsregistreringer — 4 read-only endpoints til at hente skoledata.
HMAC-signerede webhooks
Events på kursist-oprettelse, karakter-publicering, aftaleunderskrift, fravær-godkendt — signeret med skolens secret.
OpenAPI 3.1 + dev portal
Komplet OpenAPI-spec og interaktiv dokumentation på /developers. Try-out fra browseren.
Webhook-retry
Hvis modtager-endpoint er nede: exponential backoff med op til 24 timers retry. Dead-letter-kø med advarsel til skoleadmin.
Audit på API-kald
Hvert API-kald logges med tidspunkt, endpoint, API-nøgle og resultat. Misbrug fanges hurtigt.
Rate-limiting
100 req/min pr. API-nøgle. Skala kan forhøjes for legitime use-cases. Beskytter mod misbrug og uoptimerede klienter.
BI / Datawarehouse-eksport
Skolen kan hver nat hente fuld aggregat-eksport til eget BI-system (PowerBI, Tableau, Qlik). Strukturerede dimensioner og facts.
I praksis
Egen skole-app
IT-afdelingen bygger en simpel iOS-app der viser kursistens skema med push-notifikationer. Bruger Erhverv.ai's REST API + webhooks.
BI-rapportering
Skolen henter natlig CSV til Power BI for at lave egne ledelsesrapporter ud over de indbyggede analytics.
Integration med ekstern CRM
Virksomheds-database synkroniseres med skolens CRM via webhooks: ny uddannelsesaftale → opret kontakt i Salesforce.
Ofte stillede spørgsmål
Klar til at se det?
20 minutters demo tilpasset jeres skoletype.