# 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.

In Kinmu öffnen: <https://my.kinmu.app/de/dashboard/company#public-api>

## Im Browser

1. ### Unternehmen öffnen

   Öffne auf dem Smartphone zuerst das Menü über die Menüschaltfläche.

   Wähle **Mein Unternehmen**.

   Die Unternehmenseinstellungen erscheinen.

2. ### API öffnen

   Öffne auf der Seite **Mein Unternehmen** unter **Erweiterungen** den Eintrag **Öffentliche API**.

   Der Reiter **API-Schlüssel** öffnet sich.

   ![API-Schlüsselliste in Öffentliche API geöffnet](https://kinmu.app/help/de/k0028-02.webp)

3. ### Schlüssel anlegen

   Wähle **API-Schlüssel erstellen**.

   ![Formular für einen API-Schlüssel geöffnet](https://kinmu.app/help/de/k0028-03.webp)

   Das Formular öffnet sich.

4. ### 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 des API-Schlüssels eingetragen](https://kinmu.app/help/de/k0028-04.webp)

   Name und Umgebung stehen im Formular.

5. ### Ablauf festlegen

   Wähle die Gültigkeitsdauer oder einen Schlüssel ohne Ablaufdatum.

   ![Gültigkeitsdauer des API-Schlüssels ausgewählt](https://kinmu.app/help/de/k0028-05.webp)

   Die gewählte Laufzeit wird angezeigt.

6. ### Berechtigungen wählen

   Aktiviere nur die Berechtigungen, die deine Integration benötigt.

   ![Berechtigungen des API-Schlüssels ausgewählt](https://kinmu.app/help/de/k0028-06.webp)

   Die ausgewählten Zugriffsrechte sind markiert.

7. ### Schlüssel erstellen

   Wähle **Schlüssel erstellen**.

   Der vollständige Schlüssel erscheint einmalig.

8. ### 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](https://docs.kinmu.app/).