API-documentatie

Live · geen mockdata

Een 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.

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.

Beschikbare endpoints

GET/api/v1/assessmentsAlle toetsen van je organisatie.
GET/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.