Skip to Content

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_...
EndpunktRückgabe
GET /api/v1/meDeine Benutzer-ID, dein Name und deine E-Mail-Adresse
GET /api/v1/toursAlle Touren, auf die du Zugriff hast
GET /api/v1/tours/:tourId/eventsZeitplantermine 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.

Last updated on