Goed om te weten
Specificaties worden geïmporteerd uit YAML/JSON of OpenAPI met x-eduv-* extensies.
Pagina laden…
Gids 02 · Specificaties · Stap 1 van 4
Waar de runtime zijn waarheid haalt
Deze pagina is de bron voor API-identiteit, versie en lifecycle. Alles wat later in sandbox, testcases en runs verschijnt, hangt af van wat hier gepubliceerd en beheerd wordt.
Gids 02 · Specificaties · Stap 2 van 4
Sectoren bundelen API's per onderwijsdomein
Wat hier 'API' heet is in werkelijkheid een sector — een bundel API-versies die bij hetzelfde onderwijsdomein horen (bekostiging, inschrijvingen, onderwijsresultaten). Een leverancier kwalificeert per sector, niet per losse endpoint, omdat de onderlinge regels alleen samen betekenis hebben.
Gids 02 · Specificaties · Stap 3 van 4
Welke API stuurt welk gedrag
De lijst laat zien welke API-versies in beeld zijn. Dat bepaalt welke endpoints, testsets en validatieregels elders beschikbaar worden.
Waarom dit telt
Specificaties zijn geen documentarchief. Ze sturen rechtstreeks welke testsets, endpoints en validaties elders zichtbaar en uitvoerbaar zijn.
Gids 02 · Specificaties · Stap 4 van 4
Negatieve regels koppelen
Status- en foutcodes vertellen de engine welk negatief gedrag nog steeds 'correct' kan zijn. Zonder deze mapping blijft foutenafhandeling elders oppervlakkig.
Goed om te weten
Foutcodes hangen aan endpoints via de patronenpagina onder 'Koppeling API / codes'.
Waarom dit telt
Pas samen vertellen specificatieversies en foutregels wat 'goed gedrag' is, ook wanneer een API bewust geen 200 teruggeeft.
Wat lever deze gids je op
Je weet hoe je een specificatie vindt en wat er aan vasthangt.