API-documentatie

API- en datamodel-architectuur

ResultaatRegie is ontworpen rond een helder datamodel voor examenseries, WOLF-domeinen, kwaliteitsanalyses 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.

exam_series

Eén examenserie: vak, schooljaar, cohort, examentype (SE/CE), status (draft / actief / geanalyseerd).

wolf_domains

WOLF-domeinscores binnen een examenserie, met schoolscore, referentiescore en vorige score.

quality_analyses

Analyse-object met bewijs (evidence) en hypotheses, met een expliciet goedkeuringsveld (approved_by/approved_at).

interventions

Interventie met eigenaar, nulmeting, doelwaarde, huidige waarde, succesmetriek en evaluatiedatum.

intervention_events

Gebeurtenissen per interventie: reminder, check-in, evaluatie of besluit.

Voorbeeld: interventiestatus opvragen

Illustratief endpoint-voorbeeld op basis van het datamodel hierboven.

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

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