Möchtest du Photovate mit einem eigenen Programm oder einem Partner verbinden, brauchst du einen Zugang zur Photovate-API. Diesen Zugang legst du als API-Token an.
Voraussetzungen
Die Einstellungen und damit die Seite „Integrationen" erreichst du nur mit Administratorrechten.
Was ein Token darf
Ein Token gehört immer zu einem Mitarbeiter und hat genau dessen Rechte. Ein Programm, das mit dem Token arbeitet, sieht und ändert also nur, was dieser Mitarbeiter in Photovate sehen und ändern darf. Ein Token läuft nicht ab – er gilt, bis du ihn löschst.
Tipp: Lege für jede Integration einen eigenen Token an. Dann kannst du einen Zugang gezielt löschen, ohne die anderen zu stören.
Token anlegen
- Öffne
Einstellungen → Integrationen. - Klicke beim Eintrag „API-Tokens" auf „Verwalten".
- Wähle unter „Mitarbeiter" aus, mit wessen Rechten der Token arbeiten soll. Zur Auswahl stehen alle nicht archivierten Mitarbeiter mit Zugang.
- Gib unter „Bezeichnung" einen Namen ein, an dem du die Integration wiedererkennst, etwa den Namen des Partners. Erlaubt sind höchstens 100 Zeichen.
- Klicke auf „Token erstellen".
Der neue Token erscheint direkt darunter, mit dem Hinweis „Jetzt kopieren und sicher speichern. Wird nur einmal angezeigt." Kopiere ihn sofort und bewahre ihn sicher auf. Nach dem Schließen des Dialogs kannst du ihn nicht mehr einsehen.
Für die Einrichtung deiner Integration findest du im selben Dialog die „API-Adresse", den „Öffentlicher Key (Anon-Key)" sowie den Link „API-Dokumentation". Wie ein Programm diese Angaben zusammen mit dem Token verwendet, steht in der API-Dokumentation.
Übersicht der Tokens
Die Tabelle im Dialog zeigt alle Tokens deines Betriebs mit „Bezeichnung", „Mitarbeiter" und dem Datum unter „Erstellt". Ein Token mit dem Kennzeichen „Gesperrt" funktioniert nicht mehr. Gibt es noch keinen Token, steht dort „Noch keine Tokens."
Auf der Seite „Integrationen" siehst du beim Eintrag „API-Tokens", wie viele Tokens aktiv sind.
Token löschen
- Klicke in der Tabelle in der Zeile des Tokens auf das Papierkorbsymbol.
- Bestätige im Dialog „Token löschen" mit „Löschen".
Der Token funktioniert danach sofort nicht mehr. Jede Integration, die ihn benutzt, verliert ihren Zugang.
Wenn es nicht klappt
| Problem | Was du prüfen kannst |
|---|---|
| Der Token wurde nicht kopiert, bevor du den Dialog geschlossen hast | Lösche ihn und lege einen neuen an. |
| Die Integration darf bestimmte Daten nicht lesen oder ändern | Prüfe die Rolle des Mitarbeiters, dem der Token gehört. Der Token hat genau dessen Rechte. |
| Unter „Bezeichnung" erscheint „Höchstens 100 Zeichen" | Kürze die Bezeichnung. |
War dieser Artikel hilfreich?
Das ist großartig!
Vielen Dank für das Feedback
Leider konnten wir nicht helfen
Vielen Dank für das Feedback
Feedback gesendet
Wir wissen Ihre Bemühungen zu schätzen und werden versuchen, den Artikel zu korrigieren