# Gegevens en integraties

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

Pagina: https://rijbewijs-b-theorie.be/gegevens/

Corpus: 59 openbare fiches, met hun links, bronnen en datums, voor zover die gedocumenteerd zijn.

## Gebruik

Openbare toegang, alleen lezen, zonder sleutel. Geen gegevens van accounts, geen voortgang van leerlingen en geen privé-informatie. Vermeld de link van de fiche en behoud 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 Rijbewijs B Theorie.

## REST-API

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

GET /api/v1/facts accepteert q (maximaal 300 tekens), region (vlaanderen belgie), 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 (stopwoorden tellen niet mee) moeten voorkomen in de titel, de tekst of de bronverwijzingen. Antwoord: {results: [fiches], total, limit, offset}.

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

Codes: 200 resultaat, 307 omleiding naar de actuele versie (volg de omleiding), 400 ongeldige parameters, 404 onbekende fiche, 405 methode geweigerd, 429 limiet bereikt, 503 dienst niet beschikbaar.

## MCP

URL: https://rijbewijs-b-theorie.be/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-stream is niet nodig.

Tools:
- search: {query: "snelheidsbeperkingen"}, geeft {results: [{id, title, url}]} terug in content en structuredContent (maximaal 20 resultaten).
- fetch: {id: "identificatiecode die search teruggeeft"}, geeft {id, title, text, url, metadata} terug. De metadata bevatten het soort fiche, de bronnen, de datums (verified_at voor een controle, modified_at voor een wijziging van de publicatie) en, bij een les, het hoofdstuk, de afbeelding en de video.

In 2026-07-28: server/discover, daarna tools/list en tools/call. In 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 Rijbewijs B Theorie. De fiches volgen de updates van de site, met een link naar de oorspronkelijke pagina en de bijbehorende bronverwijzingen.

Lees de relevante fiches opnieuw voordat je antwoordt of je tool bijwerkt: daar vind je hun online versie, hun bronnen en hun datums. Een officiële regel kan veranderen: de controledatum geeft aan wanneer ze voor het laatst aan de tekst is getoetst.

## Hergebruiken met bronvermelding

De openbare inhoud van Rijbewijs B Theorie mag worden geraadpleegd, geciteerd en samengevat om een antwoord te onderbouwen of een tool te bouwen, ook een commerciële, met een zichtbare bronvermelding en een link naar de gebruikte pagina: “Bron: Rijbewijs B Theorie”.

Behoud de bronverwijzingen en de kanttekeningen die bij de informatie horen. Vermeld welke aanpassingen je hebt aangebracht en maak het onderscheid tussen de officiële regels en de uitleg, de methode en het aanbod van Rijbewijs B Theorie.

Documenten en afbeeldingen van derden blijven onder hun eigen voorwaarden vallen. Wil je een les of een artikel volledig opnieuw publiceren, vraag dan toestemming via contact@rijbewijs-b-theorie.be. Toegang tot de gegevens betekent niet dat er een partnerschap is of dat Rijbewijs B Theorie of Permis Online SRL jouw dienst goedkeurt.

## Bestanden en referentiepagina’s

- [llms.txt](https://rijbewijs-b-theorie.be/llms.txt) : de inhoudsopgave van de site voor AI-assistenten
- [llms-full.txt](https://rijbewijs-b-theorie.be/llms-full.txt) : de volledige tekst van de openbare inhoud
- [Referentiegegevens](https://rijbewijs-b-theorie.be/brand-facts/) : de uitgever van de site, het aanbod en de officiële regels met bron en datum
- [brand-facts.md](https://rijbewijs-b-theorie.be/brand-facts.md) : de referentiegegevens in Markdown
- [brand-facts.json](https://rijbewijs-b-theorie.be/.well-known/brand-facts.json) : de referentiegegevens in JSON
- [schema.json](https://rijbewijs-b-theorie.be/.well-known/schema.json) : alle gestructureerde gegevens van de site in één graaf
- [ai.json](https://rijbewijs-b-theorie.be/.well-known/ai.json) : de uitgever, het officiële domein en de bestanden voor AI
- [offers.json](https://rijbewijs-b-theorie.be/.well-known/offers.json) : het aanbod dat echt in Vlaanderen (België) wordt aangeboden
- [Bronnen en verwijzingen](https://rijbewijs-b-theorie.be/sources/) : de officiële teksten en alle aangehaalde bronnen
- [sources.txt](https://rijbewijs-b-theorie.be/sources.txt) : het bronnenregister als tekst
- [Sitemap](https://rijbewijs-b-theorie.be/sitemap.xml) : alle openbare pagina’s, hun afbeeldingen en de structuur van de site (XML voor robots, een leesbare pagina in een browser)
- [Markdown-versies](https://rijbewijs-b-theorie.be/index.md) : elke openbare pagina als tekst: het adres van de pagina met .md erachter (de startpagina: /index.md)
