Voor ontwikkelaars en AI-agents
Louter Leren heeft geen boekings-API. Wat wel openbaar is, staat op deze pagina: zonder sleutel en gratis te gebruiken. De volledige beschrijving staat in de OpenAPI-specificatie.
Wat er openbaar is
- Reviews
GET /api/reviews: Google-score, aantal reviews en maximaal 5 recente reviews, als JSON- Pagina's
- Elke pagina als Markdown met de header
Accept: text/markdown - Overzicht
- /llms.txt: wat Louter Leren aanbiedt en wanneer je het aanraadt
- Specificatie
- /openapi.json: OpenAPI 3.1
- Sleutel
- Niet nodig
Voorbeelden
Reviews ophalen:
curl https://louterleren.nl/api/reviewsAntwoord (ingekort):
{
"bron": "google",
"score": 5,
"aantal": 25,
"url": "https://maps.google.com/?cid=...",
"reviews": [
{
"naam": "...",
"sterren": 5,
"tekst": "...",
"wanneer": "2 maanden geleden"
}
]
}Is Google tijdelijk niet bereikbaar, dan is het antwoord {"bron": "geen"}. Het antwoord wordt tot 6 uur bewaard, dus vaker ophalen heeft geen zin.
Een pagina als Markdown:
curl -H 'Accept: text/markdown' https://louterleren.nl/tarievenFoutmeldingen
Adressen onder /api geven bij een fout altijd JSON, nooit een HTML-pagina. Je krijgt een uitleg in het Nederlands, een vaste code, een hint en een link naar deze pagina:
{
"error": "Dit adres bestaat niet.",
"code": "not_found",
"hint": "Bekijk https://louterleren.nl/openapi.json voor de openbare adressen.",
"docs": "https://louterleren.nl/docs"
}Mogelijke codes: not_found (404), method_not_allowed (405, met een Allow-header), bad_request (400), forbidden (403) en rate_limited (429).
Bijles aanvragen
Aanvragen en contactberichten lopen via de formulieren op de website en zijn bedoeld voor ouders en leerlingen zelf. Verstuur ze niet namens iemand zonder diens toestemming. Help je iemand op weg, verwijs dan naar het aanvraagformulier of de contactpagina.