API-documentatie
Live · geen mockdataEen echte, werkende API voor integraties
ToetsIntelligentie heeft een live, met een API-sleutel beveiligde API voor read-only toegang tot je eigen toetsen en interventies. Genereer een sleutel via Instellingen → API-sleutels binnen je omgeving.
Kernentiteiten
Elke organisatie (schoolbestuur of school) werkt in een volledig gescheiden omgeving, afgeschermd via database-rijbeveiliging.
assessmentsEén toets: vak, klas, schooljaar, status (draft / actief / geanalyseerd).
questionsVragen binnen een toets, met vaardigheidsdomein en referentie-p-waarde.
student_scoresScore per leerling per toets, inclusief afwezigheidsvlag.
analysesAnalyse-object met bewijs (evidence) en hypotheses, gekoppeld aan toets, klas, leerling, vraag of domein.
interventionsVoorgestelde of actieve interventie, met eigenaar, succesmetriek en evaluatiedatum.
Beschikbare endpoints
/api/v1/assessmentsAlle toetsen van je organisatie./api/v1/interventionsAlle interventies van je organisatie.Voorbeeld
Elke aanroep vereist een Authorization: Bearer <API-sleutel>-header.
curl https://toetsintelligentie.elhoucineautomation.nl/api/v1/interventions \
-H "Authorization: Bearer <API-sleutel>"
Response 200:
{
"data": [
{
"id": "d290f1ee-...",
"title": "Tweewekelijkse meetkunde-retrieval",
"status": "proposed",
"success_metric": "Domeinscore 54% naar 64%",
"evaluate_on": "2026-10-08"
}
]
}Alleen lezen (GET), read-only. Meer schrijfendpoints volgen op basis van vraag.