> For the complete documentation index, see [llms.txt](https://docs.spiroq.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.spiroq.com/de/hub-bildschirme/hub/obecne/operator-api.md).

# Betreiber-API

**Einstellungen → Betreiber-API** ist ab dem Tarif **Enterprise** verfügbar. Hier erstellen Sie den Schlüssel, mit dem Ihr ERP, WMS oder KI-Assistent die [Betreiber-API](/de/operator-api/operator-api.md) aufruft. Der Schlüssel gilt für die gesamte Automatenflotte Ihres Betreibers (Ihres Unternehmens). Das Token **gehört nicht** in den Browser und nicht in die App auf dem Automaten — es gehört in die Secrets auf Ihrem Server.

Das Erstellen des Schlüssels und die erste Anfrage sind im Kapitel [Verbindung und API-Schlüssel](/de/operator-api/operator-api/pripojeni.md) beschrieben.

## Schlüssel erstellen

Füllen Sie den **Schlüsselnamen** aus (z. B. `WMS produkce`, höchstens 80 Zeichen). Ein leerer Name wird als `API key` gespeichert.

Die **Berechtigung** wählen Sie beim Erstellen, später lässt sie sich nicht mehr ändern:

| Berechtigung          | Wann Sie sie verwenden                                                                                                                 |
| --------------------- | -------------------------------------------------------------------------------------------------------------------------------------- |
| **Nur lesen**         | Berichte, Bestandsübersicht, KI-Assistent, der Geräte, Fächer und Katalog nur lesen soll. Jeden Schreibvorgang lehnt die API ab.       |
| **Lesen & Schreiben** | ERP, WMS oder KI-Assistent, der auffüllen, leeren, das Produkt im Fach ändern, Produkte anlegen oder einen Befüllungsplan senden soll. |

Wählen Sie einen Schlüssel nur zum Lesen immer dann, wenn die Integration nichts in den Automaten schreibt. **Bei einem Leak eines Schlüssels mit voller Berechtigung lassen sich Bestand und Layout der gesamten Flotte ändern.**

**Schlüssel erstellen** zeigt das Token **nur einmal** und kopiert es in die Zwischenablage. Speichern Sie es sofort. Im HUB finden Sie es nicht wieder.

In der Liste sehen Sie Name, Berechtigung, **Präfix** des Tokens, Erstellungsdatum und wann es zuletzt verwendet wurde. **Widerrufen** schaltet den Schlüssel aus. Ein neuer Schlüssel hat ein anderes Token — tauschen Sie es in der Integration aus und widerrufen Sie erst danach den alten.