Skip to Content

Developer-API

Met de Developer-API van TourPro kunnen je eigen scripts en integraties je gegevens uitlezen. Toegang verloopt via persoonlijke toegangstokens: elk token handelt namens jou en ziet alleen de tours die jij mag zien.

Fase 1 is alleen-lezen: je kunt je eigen gebruikersgegevens, je tours en geplande events ophalen.

Een token aanmaken

Open je profiel

Open in de web-app je Profiel (Profile) en kies het tabblad Developer.

Maak het token aan

Klik op Token aanmaken (Create token), geef het een duidelijke naam (bijvoorbeeld het script of de dienst die het gebruikt) en bevestig.

Kopieer het direct

TourPro toont het token maar één keer. Kopieer het direct en bewaar het veilig zoals een wachtwoord. Raak je het kwijt, trek het token dan in en maak een nieuw token aan.

De API aanroepen

Stuur het token mee als Bearer-header:

Authorization: Bearer tourpro_...
EndpointGeeft terug
GET /api/v1/meJe gebruikers-id, naam en e-mailadres
GET /api/v1/toursDe tours waartoe je toegang hebt
GET /api/v1/tours/:tourId/eventsGeplande events voor een tour, gefilterd op jouw machtigingen en zichtbaarheid

De basis-URL is de API-host (bijvoorbeeld https://api.tourpro.app), niet de web-app.

curl https://api.tourpro.app/api/v1/tours \ -H "Authorization: Bearer tourpro_..."

De API heeft een limiet van 120 verzoeken per minuut per token. Boven die limiet ontvang je een 429-antwoord met RateLimit-headers die het tijdvenster aangeven.

Een token intrekken

Klik op het tabblad Developer op Intrekken (Revoke) naast een token en bevestig. Intrekken werkt onmiddellijk en is definitief: maak een nieuw token aan als je een vervanging nodig hebt.

Wat een token kan zien

Een token ziet nooit meer dan jijzelf:

  • Tours: alleen tours die je hebt aangemaakt of waarvan je lid bent.
  • Events: alleen events die zichtbaar zijn voor jouw rol en toegewezen speeldagen op die tour, en alleen wanneer je het recht hebt om het schema te bekijken.
  • Alles is alleen-lezen. Niets in de API kan je gegevens wijzigen.

Ingelogde browsersessies uit de app werken niet op de API. De v1-endpoints accepteren uitsluitend tourpro_-tokens, zodat een gestolen browsersessie niet tegen de API kan worden hergebruikt.

Last updated on