API-Tokens erstellen und verwalten
Tokens für den programmatischen Zugriff auf Datensätze anlegen, Berechtigungen je Datentyp vergeben und Tokens widerrufen.
API-Tokens ermöglichen programmatischen Zugriff auf deine Datensätze – etwa aus einem CRM, einer App oder einem Automatisierungstool. Du verwaltest sie unter Datensätze → API-Tokens (/data/tokens).
Token anlegen
Klicke auf Token hinzufügen.
Vergib einen Namen, der den Einsatzzweck beschreibt, z. B. „CRM-Synchronisation“.
Wähle unter Berechtigungen je Datentyp Lesen und/oder Schreiben.
Klicke auf Speichern.
Kopiere das Token sofort. Es wird nur einmal angezeigt.
Mosaio speichert nur einen Hash des Tokens. Geht es verloren, kannst du es nicht wieder anzeigen – widerrufe es und lege ein neues an.
Berechtigungen
| Scope | Erlaubt |
|---|---|
data:<handle>:read | Veröffentlichte Einträge dieses Datentyps lesen |
data:<handle>:write | Neue Einträge dieses Datentyps als Entwurf anlegen |
Vergib nur die Rechte, die eine Integration wirklich braucht. Für eine Website-Integration, die nur liest, genügt read.
Überwachen und widerrufen
Die Liste zeigt je Token Name, Berechtigungen und Letzte Nutzung. Mit Widerrufen wird ein Token sofort ungültig – alle Anfragen damit erhalten 401.
Sicher speichern
Tokens gehören in Umgebungsvariablen oder einen Secret-Manager, nie in Quellcode oder Frontend-JavaScript.
Nutze je Integration ein eigenes Token, damit du einzelne Zugänge gezielt widerrufen kannst.
Unser Support antwortet in der Regel innerhalb eines Werktags.