API-Schlüssel für Ihre eigenen Systeme erstellen und verwalten

1. 01

   Ihren Tarif prüfen

   API-Schlüssel gehören zur Edition Chain; siehe Tarif & Abrechnung. Schlüssel funktionieren ab dem Tag nicht mehr, an dem ein Workspace Chain verlässt. Den Bereich Integrationen › API und Webhooks sehen nur Personen mit der Berechtigung für die Workspace-Einstellungen, etwa Inhaber und Admins.

2. 02

   Einen Schlüssel erstellen

   Klicken Sie auf „Neuer Schlüssel“. Benennen Sie ihn unter „Wofür er ist“ nach dem System, das ihn nutzen wird. Kreuzen Sie unter „Worauf er zugreift“ Modul für Modul nur an, was er braucht; „schreiben“ schließt „lesen“ ein. Lassen Sie alles leer, erhält der Schlüssel Ihren vollen Zugriff.

3. 03

   Einmal kopieren

   Der Schlüssel erscheint einmal, unter „Ihr neuer Schlüssel“. Kopieren Sie ihn in das andere System. Er wird in Setvos nicht gespeichert und kann nicht erneut angezeigt werden: Ein verlorener Schlüssel wird ersetzt, nicht wiederhergestellt.

4. 04

   Den Schlüssel nutzen

   Die Karte zeigt die API-Adresse, an die Anfragen gehen, und „API-Schnellstart“ öffnet unsere Anleitung. Ein Schlüssel handelt als Sie: Er kann, was Ihre Rolle erlaubt, und nicht mehr, und er funktioniert nicht mehr, wenn Sie den Workspace verlassen. Er arbeitet nur mit den Daten des Workspace: Er kann Ihr Konto nicht ändern, keine Schlüssel anlegen oder ersetzen und nichts außerhalb des Workspace öffnen. Ein auf einige Module beschränkter Schlüssel erreicht nur diese – weder die Suche noch die Einstellungen des Workspace.

5. 05

   Einen Schlüssel vor dem Ablauf ersetzen

   Ein Schlüssel funktioniert ein Jahr nach seiner Ausstellung nicht mehr und ist vorher mit „Läuft bald ab“ markiert. Klicken Sie daneben auf die Schaltfläche „Schlüssel ersetzen“ (die kreisenden Pfeile): Der neue Schlüssel behält Namen, Reichweite und erlaubte Adressen und gilt ein Jahr. Tragen Sie ihn im anderen System ein und widerrufen Sie dann den alten – oder kreuzen Sie „Alten Schlüssel jetzt widerrufen (was ihn noch nutzt, funktioniert dann nicht mehr)“ an.

6. 06

   Einen Schlüssel widerrufen

   Klicken Sie neben einem Schlüssel, der nicht mehr gebraucht wird oder in falsche Hände geraten sein könnte, auf die Schaltfläche „Widerrufen“ (der Papierkorb). Setvos fragt zuerst nach: Tippen Sie zur Bestätigung den Namen des Schlüssels ein und klicken Sie auf „Widerrufen“. Der Schlüssel funktioniert sofort nicht mehr und lässt sich nicht zurückholen; er bleibt mit „Widerrufen“ markiert in der Liste, damit sein Verlauf erhalten bleibt. Braucht das andere System weiter Zugang, ersetzen Sie den Schlüssel zuerst.

Aktualisiert am 6. Oktober 2026