Personal Access Token

meetergo ermöglicht es dir, einfach einen persönlichen Zugriffstoken zu generieren, den du zur Authentifizierung mit der meetergo-API verwenden kannst.

Persönliche Zugriffstoken sind ab dem Essentials-Plan verfügbar.

Dein persönlicher Zugriffstoken sollte nicht mit Personen außerhalb deiner Organisation geteilt werden.

Persönlichen Zugriffstoken erstellen

Befolge diese Schritte, um einen persönlichen Zugriffstoken zu erstellen und ihn mit unserer API zu verwenden:

Melde dich bei deinem meetergo-Konto an und navigiere zu Integrationen & Apps
Finde den Bereich "Persönliche Zugriffstoken"
Klicke auf "Token erstellen", um einen neuen Zugriffstoken zu generieren

Um deinen Token zu erstellen, musst du ihm einen eindeutigen Namen geben. Du kannst optional ein Ablaufdatum festlegen.

Stelle sicher, den Token an einem sicheren Ort zu kopieren, da er nach der Erstellung nicht erneut angezeigt werden kann.

Verwendung

Um auf geschützte Ressourcen zuzugreifen, muss dein persönlicher Zugriffstoken (im vorherigen Schritt kopiert) als Bearer-Token im Authorization-Header deiner Anfrage angegeben werden.

Beispiel-Header:

Authorization: Bearer dein_token_hier

Weitere detaillierte Anweisungen zur Verwendung der API-Endpunkte findest du in unserer API-Dokumentation.

Worauf der Token zugreifen kann

Ein Personal Access Token handelt in deinem Namen. API-Aufrufe verhalten sich genau wie Aktionen, die du selbst im meetergo-Dashboard ausführst, mit deiner Rolle und deinen Berechtigungen:

Als reguläres Mitglied kann der Token deine eigenen Meeting-Typen, Verfügbarkeiten und Buchungen verwalten.
Als Admin kann der Token zusätzlich Daten im gesamten Workspace lesen und verwalten, zum Beispiel Benutzer auflisten oder die Termine anderer Benutzer abrufen.

Der Token kann keine Benutzer erstellen, aktualisieren oder löschen und nicht im Namen anderer Benutzer handeln. Diese Funktionen erfordern die meetergo API Platform. Details findest du in der Entwickler-Dokumentation.

Wird der Besitzer des Tokens aus dem Workspace entfernt, funktioniert der Token nicht mehr. Erstelle den Token für wichtige Integrationen deshalb über ein gemeinsames Admin-Konto (zum Beispiel integrations@deinefirma.de).

Sicherheit

Aus Sicherheitsgründen wird der Token nicht auf unseren Servern gespeichert. Das bedeutet, dass du deinen Token nach der Ausstellung nicht mehr einsehen kannst.

Darüber hinaus empfehlen wir, ein Ablaufdatum für deine Tokens festzulegen. Nach Ablauf des Tokens kann er nicht mehr zur Authentifizierung bei der API verwendet werden.

Wenn du einen deiner Tokens widerrufen möchtest, kannst du dies mit der Schaltfläche "Widerrufen" neben dem Token tun. Sobald du einen Token widerrufen hast, kann er nicht mehr zur Authentifizierung bei der API verwendet werden.