De openbare API van Rijbewijs B Theorie

De adressen

De zoekparameters

• q: de woorden die je zoekt (maximaal 300 tekens). Accenten worden genegeerd; alle betekenisvolle woorden (stopwoorden tellen niet mee) moeten voorkomen in de titel, de tekst of de bronverwijzingen.
• kind: het soort fiche (fact, expertise, organization, offer, person, article, lesson, page, tool).
• region: vlaanderen belgie, het gebied waarop de officiële regels en de lessen betrekking hebben.
• limit: van 1 tot 50 (standaard 10); offset: van 0 tot 10.000 (standaard 0).

Het eerste verzoek wordt omgeleid (307) naar hetzelfde adres met po_live=1, zodat je altijd actuele gegevens leest: volg de omleiding (curl: --location). Codes: 200, 307, 400 (ongeldige parameter), 404 (onbekende fiche), 405 (methode geweigerd), 429 (limiet bereikt, zie Retry-After), 503 (dienst niet beschikbaar).

Vanuit een browser

Publieke CORS voor GET, zonder cookie of sleutel: gebruik credentials: 'omit'. De header Retry-After is leesbaar vanaf een andere site. Om de hele catalogus te lezen, loop je de API pagina per pagina af en ontdubbel je op identificatiecode.

Voorbeelden om te kopiëren

Zoeken met curl

Deze openbare zoekopdracht geeft maximaal drie fiches terug, met hun tekst en hun verwijzingen. Een sleutel is niet nodig.

curl --location --fail --silent --show-error --get \
  'https://rijbewijs-b-theorie.be/api/v1/facts' \
  --header 'Accept: application/json' \
  --data-urlencode 'q=examen' \
  --data 'kind=fact' \
  --data 'limit=3'

Fiches en hun bronnen tonen op een webpagina

Plaats deze JavaScript na de inhoud van je pagina, in een script van het type module. Die code toont de teksten, een zichtbare bronvermelding en de verwijzingen met veilige links, zonder cookie of sleutel.

await (async () => {
  const section = document.createElement('section');
  section.setAttribute('aria-label', 'Informatie van ' + "Rijbewijs B Theorie");
  const status = document.createElement('p');
  status.setAttribute('role', 'status');
  status.textContent = 'Informatie laden…';
  section.append(status);
  document.body.append(section);

  const link = (label, address) => {
    const text = String(label || address || 'Verwijzing');
    try {
      const url = new URL(address);
      if (!['https:', 'http:'].includes(url.protocol)) throw new Error();
      const anchor = document.createElement('a');
      anchor.textContent = text;
      anchor.href = url.href;
      return anchor;
    } catch {
      const span = document.createElement('span');
      span.textContent = text;
      return span;
    }
  };

  try {
    const url = new URL('https://rijbewijs-b-theorie.be/api/v1/facts');
    url.search = new URLSearchParams({ q: 'examen', kind: 'fact', limit: '3' });
    const response = await fetch(url, {
      credentials: 'omit',
      headers: { Accept: 'application/json' },
      signal: AbortSignal.timeout(15000)
    });
    if (!response.ok) {
      if (response.status === 429) {
        const retry = Number(response.headers.get('Retry-After'));
        throw new Error(Number.isFinite(retry) && retry > 0
          ? `Limiet bereikt. Probeer het opnieuw over ${Math.ceil(retry)} seconden.`
          : 'Limiet bereikt. Probeer het over een minuut opnieuw.');
      }
      throw new Error(`De informatie is niet beschikbaar (HTTP ${response.status}).`);
    }
    const data = await response.json();
    if (!Array.isArray(data.results)) throw new Error('Het ontvangen antwoord is ongeldig.');
    for (const record of data.results) {
      const article = document.createElement('article');
      const title = document.createElement('h2');
      title.textContent = record.title;
      const text = document.createElement('p');
      text.textContent = record.text;
      text.style.whiteSpace = 'pre-line';
      const attribution = document.createElement('p');
      attribution.append('Bron: ', link("Rijbewijs B Theorie" + ', bekijk deze fiche', record.url));
      article.append(title, text, attribution);
      if (record.verified_at) {
        const date = document.createElement('p');
        date.textContent = `Gepubliceerde controledatum: ${record.verified_at}`;
        if (record.verification_scope) date.textContent += ` · ${record.verification_scope}`;
        article.append(date);
      }
      const references = document.createElement('ul');
      for (const source of record.sources || []) {
        const item = document.createElement('li');
        item.append(link(source.label || source.title || source.url, source.url));
        references.append(item);
      }
      for (const reference of record.bibliography || []) {
        const item = document.createElement('li');
        item.textContent = reference;
        references.append(item);
      }
      if (references.childElementCount) article.append(references);
      for (const related of record.related || []) {
        const context = document.createElement('p');
        context.append('Lees hierbij ook: ', link(related.title, related.url), ` ${related.text || ''}`);
        article.append(context);
      }
      section.append(article);
    }
    status.textContent = data.results.length ? `${data.results.length} fiche(s) getoond.` : 'Geen fiche gevonden.';
  } catch (error) {
    status.textContent = error.name === 'TimeoutError'
      ? 'Het laden duurt te lang. Probeer het zo meteen opnieuw.'
      : error.message || 'Het laden is mislukt.';
  }
})();

Resultaten doorlopen in Python 3

Je hoeft geen bibliotheek te installeren. Elke regel in de uitvoer bevat een volledige fiche met haar URL en haar bronnen. De paginering stopt bij het laatste resultaat. Na een 429-antwoord houdt het script rekening met Retry-After, met maximaal drie nieuwe pogingen en een stop als de gevraagde wachttijd langer is dan een minuut.

import json
import time
from email.utils import parsedate_to_datetime
from urllib.error import HTTPError
from urllib.parse import urlencode
from urllib.request import Request, urlopen

API = "https://rijbewijs-b-theorie.be/api/v1/facts"

def request_json(url):
    for attempt in range(4):
        try:
            request = Request(url, headers={"Accept": "application/json"})
            with urlopen(request, timeout=15) as response:
                return json.load(response)
        except HTTPError as error:
            retry_after = error.headers.get("Retry-After", "")
            status = error.code
            error.close()
            if status != 429 or attempt == 3:
                raise RuntimeError(f"Verzoek onderbroken: HTTP {status}") from error
            try:
                delay = float(retry_after)
            except ValueError:
                try:
                    delay = parsedate_to_datetime(retry_after).timestamp() - time.time()
                except (ValueError, TypeError, OverflowError):
                    delay = 2 ** attempt
            if not 0 <= delay <= 60:
                raise RuntimeError("Wachttijd te lang. Hervat het ophalen later.") from error
            time.sleep(max(1, delay))

def iter_records(query="examen"):
    offset = 0
    while offset <= 10000:
        params = {"q": query, "kind": "fact", "limit": 50, "offset": offset}
        page = request_json(API + "?" + urlencode(params))
        rows, total = page["results"], page["total"]
        if not isinstance(rows, list) or not isinstance(total, int):
            raise RuntimeError("Ongeldig API-antwoord.")
        if not rows:
            if offset < total:
                raise RuntimeError("Lege pagina vóór het einde van de resultaten.")
            return
        yield from rows
        offset += len(rows)
        if offset >= total:
            return
    raise RuntimeError("Paginalimiet bereikt. Verfijn je zoekopdracht.")

if __name__ == "__main__":
    for record in iter_records():
        print(json.dumps(record, ensure_ascii=False))

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.