Wie erstelle ich einen API-Schlüssel für eine Integration?
Öffne in Kinmu Mein Unternehmen und Öffentliche API, wähle API-Schlüssel erstellen und lege Name, Ablauf und Berechtigungen fest. Kopiere den Schlüssel direkt nach dem Erstellen.
Auf dieser Seite
Im Browser
Unternehmen öffnen
Öffne auf dem Smartphone zuerst das Menü über die Menüschaltfläche.
Wähle Mein Unternehmen In Kinmu öffnen Wenn dein Unternehmen Öffentliche API nutzt..
Die Unternehmenseinstellungen erscheinen.
API öffnen
Öffne auf der Seite Mein Unternehmen unter Erweiterungen den Eintrag Öffentliche API.
Der Reiter API-Schlüssel öffnet sich.
Schlüssel anlegen
Wähle API-Schlüssel erstellen.
Das Formular öffnet sich.
Namen eingeben
Gib einen Namen für die Integration ein. Falls eine Umgebungsauswahl erscheint, wähle Produktion oder Sandbox. Die Sandbox verwendet ein Testunternehmen mit synthetischen Daten.
Name und Umgebung stehen im Formular.
Ablauf festlegen
Wähle die Gültigkeitsdauer oder einen Schlüssel ohne Ablaufdatum.
Die gewählte Laufzeit wird angezeigt.
Berechtigungen wählen
Aktiviere nur die Berechtigungen, die deine Integration benötigt.
Die ausgewählten Zugriffsrechte sind markiert.
Schlüssel erstellen
Wähle Schlüssel erstellen.
Der vollständige Schlüssel erscheint einmalig.
Schlüssel kopieren
Kopiere den Schlüssel, bewahre ihn sicher auf und schließe den Dialog.
In der Liste ist nur noch die maskierte Version sichtbar.
Wenn etwas fehlt
- Die Erweiterung für die öffentliche API muss unter Mein Unternehmen und Erweiterungen aktiviert sein.
- Erforderliche Rollen: Globaler Administrator, Manager.
- Ist die maximale Anzahl aktiver Schlüssel erreicht, widerrufe einen nicht mehr benötigten Schlüssel.
- Wähle mindestens eine Berechtigung aus.
Häufige Fragen
Kann ich einen verlorenen Schlüssel erneut anzeigen?
Nein. Ersetze ihn über die Rotationsfunktion oder erstelle einen neuen. Bei einer Rotation wird der alte Schlüssel sofort ungültig. Aktualisiere deine Integration.
Wie sperre ich einen Schlüssel?
Öffne ihn in der Liste und widerrufe ihn. Er wird sofort ungültig. Das lässt sich nicht rückgängig machen.
Ergebnis
Der Schlüssel ist erstellt. Deine Integration sendet ihn im Header Authorization: Bearer. Die technische Dokumentation findest du unter docs.kinmu.app.
Nicht gefunden? Schreib uns