Entwickler-API
Über die Entwickler-API von TourPro können eigene Skripte und Integrationen deine Tourdaten auslesen. Der Zugriff läuft über persönliche Zugriffstokens (Personal Access Tokens): Jedes Token handelt in deinem Namen und sieht ausschließlich die Touren und Inhalte, auf die auch du Zugriff hast.
Phase 1 bietet reinen Lesezugriff: Du kannst deine Benutzerkennung, deine Touren und Zeitplantermine abrufen.
Ein Token erstellen
Profil öffnen
Öffne in der Web-App dein Profil (Profile) und wechsle auf den Tab Entwickler (Developer).
Token anlegen
Klicke auf Token erstellen (Create token), vergib einen aussagekräftigen Namen (zum Beispiel den Namen des Skripts oder Dienstes) und bestätige.
Sofort kopieren
TourPro zeigt das Token aus Sicherheitsgründen nur ein einziges Mal an. Kopiere es direkt und bewahre es wie ein Passwort auf. Geht es verloren, widerrufe das alte Token und erstelle ein neues.
API aufrufen
Sende das Token als Bearer-Header mit:
Authorization: Bearer tourpro_...| Endpunkt | Rückgabe |
|---|---|
GET /api/v1/me | Deine Benutzer-ID, dein Name und deine E-Mail-Adresse |
GET /api/v1/tours | Alle Touren, auf die du Zugriff hast |
GET /api/v1/tours/:tourId/events | Zeitplantermine einer Tour, gefiltert nach deinen Berechtigungen und Sichtbarkeitsregeln |
Basis-URL ist der API-Host (zum Beispiel https://api.tourpro.app), nicht die Web-App.
curl https://api.tourpro.app/api/v1/tours \
-H "Authorization: Bearer tourpro_..."Die API ist auf 120 Anfragen pro Minute und Token begrenzt. Bei Überschreitung erhältst du den Statuscode 429 samt RateLimit-Headern zum aktuellen Zeitfenster.
Ein Token widerrufen
Klicke im Tab Entwickler (Developer) neben dem betreffenden Token auf Widerrufen (Revoke) und bestätige. Der Widerruf greift sofort und ist endgültig; erstelle bei Bedarf einfach ein neues Token.
Was ein Token sehen kann
Ein Token sieht niemals mehr als du selbst:
- Touren: nur Touren, die du erstellt hast oder denen du angehörst.
- Termine: nur Termine, die für deine Rolle und deinen Datumsbereich auf dieser Tour sichtbar sind, und nur dann, wenn du die Berechtigung zum Ansehen des Zeitplans hast.
- Alles ist schreibgeschützt. Über die API können keine Daten verändert werden.
Normale Browser-Sitzungen aus der App funktionieren an der API nicht. Die v1-Endpunkte akzeptieren ausschließlich tourpro_-Tokens, sodass eine entwendete Browsersitzung dort nicht missbraucht werden kann.