Overzicht
We bieden een publieke API aan waarmee je onze activiteiten en de kaartpunten van het Mannenweekend kunt lezen. Je hebt geen login of API-sleutel nodig. De API is alleen-lezen: inschrijven, betalen en ledengegevens zijn niet beschikbaar.
Authenticatie
Geen. Alle endpoints hieronder zijn publiek. Stuur gewoon een GET-verzoek.
Endpoints
Activiteiten
GET /api/raak/public-activities geeft de publieke activiteiten (titel en beschrijving), nieuwste eerst. Optionele parameters: q (zoeken op titel), page (vanaf 1) en perPage (max. 100).
curl "https://raakwijshagen.be/api/raak/public-activities?q=wandeling&perPage=5"
Kaartpunten
GET /api/raak/public-map-pins geeft de bestemmingen van het Mannenweekend. Optionele parameters: page en perPage (max. 200).
curl "https://raakwijshagen.be/api/raak/public-map-pins"
Een antwoord bevat page, perPage, totalItems, totalPages en items.
Fouten
Fouten van de API zijn altijd JSON met de velden status (HTTP-code), message (uitleg) en data (extra details, meestal leeg). Een onbekende pagina geeft een echte 404. Vraag je Accept: text/markdown mee, dan krijg je ook een korte Markdown-uitleg met verwijzingen naar deze documentatie.
{ "status": 404, "message": "The requested resource wasn't found.", "data": {} }
Machineleesbare beschrijvingen
- OpenAPI-beschrijving
- llms.txt
- API-catalogus (RFC 9727)
- AI-catalogus
- Sitemap
MCP-server
Voor AI-agents is er een alleen-lezen MCP-server (Streamable HTTP, zonder login) op https://raakwijshagen.be/mcp met de tools list_public_activities en list_map_pins. De server card beschrijft de server.