So erstellen und verwenden Sie ein API-Token

API-Token ermöglichen es einem anderen System, eine Verbindung zu Ihrem TicketingHub-Konto herzustellen. Sie benötigen Administratorzugriff, um API-Token zu verwalten.

Wofür kann ich ein API-Token verwenden?

• TicketingHub-Daten an eine Berichtssoftware oder ein Data Warehouse senden.
• Einer benutzerdefinierten Partnerplattform ermöglichen, Produkte und Preise auszulesen.
• Eine serverseitige Buchungsoberfläche erstellen, die die aktuelle Verfügbarkeit prüft.

Ein API-Token stellt keine integrierte Verbindung zu Google Sheets her. Unter So exportieren Sie TicketingHub-Daten und verbinden andere Tools erfahren Sie, wie Sie zwischen CSV-Exporten, Zapier, Webhooks und API-Zugriff wählen.

API-Zugriff aktivieren

1. Gehen Sie zu Einstellungen → Funktionen.
2. Aktivieren Sie API-Zugriff.

Diese Einstellung kann selbstständig vorgenommen werden. Nachdem Sie den Zugriff aktiviert haben, wird API-Token unter „Einstellungen“ angezeigt.

Ein Token erstellen

1. Gehen Sie zu Einstellungen → API-Token.
2. Wählen Sie API-Token generieren.
3. Geben Sie einen Namen ein, der das System identifiziert, das den Token verwendet.
4. Wählen Sie Supplier API (V2) für die Lieferantenverwaltung, Widget API für Verfügbarkeit und Buchungen oder OCTO API für die Verbindung von Systemen, die den OCTO-Standard unterstützen.
5. Wenn Sie Supplier API (V2) oder OCTO API ausgewählt haben, können Sie Nur lesen wählen, wenn die Integration nur Daten anzeigen muss. Diese Option gilt nicht für Widget API-Token.
6. Fügen Sie bei Bedarf ein Ablaufdatum hinzu und generieren Sie anschließend den Token.
7. Kopieren Sie den Token sofort und bewahren Sie ihn sicher auf. Der vollständige Token wird nur einmal angezeigt.

Den Token verwenden

Senden Sie den Token im Authorization-Header jeder API-Anfrage:

Authorization: Bearer YOUR_TOKEN

Verwenden Sie API-Token nur in sicheren serverseitigen Systemen. Fügen Sie einen Token nicht in Website-Code, E-Mails, Chatnachrichten oder gemeinsam genutzte Dokumente ein.

Einen Token widerrufen

Gehen Sie zu Einstellungen → API-Token und wählen Sie neben dem Token Widerrufen. Der Widerruf wird sofort wirksam. Das verbundene System funktioniert daher nicht mehr, bis es einen Ersatz-Token verwendet.

Erstellen Sie für jede Integration einen eigenen Token, gewähren Sie nur die benötigten Zugriffsrechte und widerrufen Sie Token, die nicht mehr verwendet werden. Für ereignisbasierte Aktualisierungen sind möglicherweise Webhooks oder die Zapier-Integration besser geeignet.