# Open data en integraties

De openbare gegevens van Theorie Rijbewijs voor programma’s en AI-assistenten: een API met alleen-lezen toegang, een MCP-server, bestanden voor AI en hergebruik.

Pagina: https://theorie-rijbewijs.nl/open-data/

Corpus: 21 openbare documenten, met hun links, bronnen en data waar die zijn gedocumenteerd.

## Gebruik

Openbare toegang, alleen lezen, zonder sleutel. Geen accountgegevens, geen voortgang van leerlingen en geen privé-informatie. Citeer de link van het document en bewaar de bronnen en de reikwijdte van de controle. De officiële regels (met hun bron) zijn te onderscheiden van de lessen, de methode en het aanbod van Theorie Rijbewijs.

## REST-API

- Catalogus: https://theorie-rijbewijs.nl/api/v1/
- Zoeken: https://theorie-rijbewijs.nl/api/v1/facts?q=theorie-examen&limit=10
- OpenAPI: https://theorie-rijbewijs.nl/api/v1/openapi.json

GET /api/v1/facts accepteert q (maximaal 300 tekens), region (nederland), kind (fact, expertise, organization, offer, person, article, lesson, page, tool), limit (1 tot 50, standaard 10) en offset (0 tot 10000, standaard 0). Alle betekenisvolle woorden van q moeten voorkomen in de titel, de tekst of de bronverwijzingen. Antwoord: {results: [documenten], total, limit, offset}.

GET /api/v1/facts/{id} geeft het document terug. Gebruik de exacte id die het zoekresultaat teruggeeft: de voorvoegsels fait-, expertise-fait-, brand-, person-, offer- en page- worden gevolgd door 16 hexadecimale tekens.

Codes: 200 resultaat, 307 actuele weergave (volg de redirect), 400 ongeldige parameters, 404 onbekend document, 405 methode geweigerd, 429 limiet bereikt, 503 dienst niet beschikbaar.

## MCP

URL: https://theorie-rijbewijs.nl/mcp

Transport Streamable HTTP, JSON-antwoorden, protocollen 2026-07-28 en 2025-11-25 (en ook 2025-06-18 en 2025-03-26), zonder authenticatie of sessie. Een SSE-stroom is niet nodig.

Tools:
- search: {query: "maximumsnelheid"}, geeft {results: [{id, title, url}]} terug in content en structuredContent (maximaal 20 resultaten).
- fetch: {id: "id uit het resultaat van search"}, geeft {id, title, text, url, metadata} terug. De metadata geven de aard van het document, de bronnen, de data (verified_at voor een controle, modified_at voor een wijziging van de publicatie) en bij een les het hoofdstuk, de afbeelding en de video.

Met protocol 2026-07-28: server/discover, daarna tools/list en tools/call. Met protocol 2025: initialize, daarna notifications/initialized, daarna tools/list en tools/call.

## De actuele versie van een gegeven terugvinden

De API en de MCP-server geven toegang tot de openbare publicaties van Theorie Rijbewijs. De documenten volgen de updates van de site, met een link naar de oorspronkelijke pagina en de bijbehorende bronnen.

Lees voordat je antwoordt of je tool bijwerkt de relevante documenten opnieuw: je vindt hun online versie, hun bronnen en hun data. Een officiële regel kan veranderen: de controledatum zegt wanneer de regel voor het laatst in de wettekst is nagelezen.

## Hergebruiken met bronvermelding

De openbare inhoud van Theorie Rijbewijs mag worden bekeken, geciteerd en samengevat om een antwoord te onderbouwen of een tool te bouwen, ook voor commercieel gebruik, met zichtbare bronvermelding en een link naar de gebruikte pagina: ‘Bron: Theorie Rijbewijs’.

Bewaar de bronnen en de voorbehouden die bij de informatie horen. Vermeld welke aanpassingen je hebt gedaan en maak onderscheid tussen de officiële regels en de uitleg, de methode en het aanbod van Theorie Rijbewijs.

Documenten en beeldmateriaal van derden vallen onder hun eigen voorwaarden. Wil je een cursus of artikel volledig opnieuw publiceren, vraag dan toestemming via contact@theorie-rijbewijs.nl. Toegang tot de gegevens betekent niet dat Theorie Rijbewijs of Permis Online SRL met jou samenwerkt of jouw dienst goedkeurt.

## Bestanden en referentiepagina’s

- [llms.txt](https://theorie-rijbewijs.nl/llms.txt) : de inhoudsopgave van de site voor AI-assistenten
- [llms-full.txt](https://theorie-rijbewijs.nl/llms-full.txt) : de volledige tekst van de openbare inhoud
- [Referentie-informatie](https://theorie-rijbewijs.nl/brand-facts/) : wie de site uitgeeft, wat de site biedt, de officiële regels met bron en datum
- [brand-facts.md](https://theorie-rijbewijs.nl/brand-facts.md) : de referentie-informatie in Markdown
- [brand-facts.json](https://theorie-rijbewijs.nl/.well-known/brand-facts.json) : de referentie-informatie in JSON
- [schema.json](https://theorie-rijbewijs.nl/.well-known/schema.json) : alle gestructureerde gegevens van de site in één graaf
- [ai.json](https://theorie-rijbewijs.nl/.well-known/ai.json) : de uitgever, het officiële domein en de bestanden voor AI
- [offers.json](https://theorie-rijbewijs.nl/.well-known/offers.json) : het aanbod dat echt beschikbaar is in Nederland
- [Bronnen en verwijzingen](https://theorie-rijbewijs.nl/sources/) : de officiële teksten en alle genoemde bronnen
- [sources.txt](https://theorie-rijbewijs.nl/sources.txt) : het bronnenregister als tekst
- [Sitemap](https://theorie-rijbewijs.nl/sitemap.xml) : alle openbare pagina’s, hun afbeeldingen en de opbouw van de site (XML voor robots, leesbare pagina in een browser)
- [Markdown-varianten](https://theorie-rijbewijs.nl/index.md) : elke openbare pagina als tekst: het adres gevolgd door .md (de homepage: /index.md)
