API-documentatie

API- en datamodel-architectuur

ToetsIntelligentie is ontworpen rond een helder datamodel voor toetsen, vragen, leerlingscores, analyses en interventies. Onderstaande weergave beschrijft de beoogde architectuur en dient als roadmapdocumentatie — de API is nog niet publiek beschikbaar.

Kernentiteiten

Elke organisatie (schoolbestuur of school) werkt in een volledig gescheiden omgeving, afgeschermd via database-rijbeveiliging.

assessments

Eén toets: vak, klas, schooljaar, status (draft / actief / geanalyseerd).

questions

Vragen binnen een toets, met vaardigheidsdomein en referentie-p-waarde.

student_scores

Score per leerling per toets, inclusief afwezigheidsvlag.

analyses

Analyse-object met bewijs (evidence) en hypotheses, gekoppeld aan toets, klas, leerling, vraag of domein.

interventions

Voorgestelde of actieve interventie, met eigenaar, succesmetriek en evaluatiedatum.

Voorbeeld: interventiestatus opvragen

Illustratief endpoint-voorbeeld op basis van het datamodel hierboven.

GET /api/interventions?status=actief
Response 200:
{
  "id": "d290f1ee-...",
  "title": "Tweewekelijkse meetkunde-retrieval",
  "status": "actief",
  "success_metric": "Domeinscore 54% naar 64%",
  "evaluate_on": "2026-10-08"
}

Dit is architectuurdocumentatie voor een platform in ontwikkeling, geen live, publiek toegankelijke API.