API Keys

Unter Entwickler verwalten Administratoren die API Keys der Organisation. Mit einem Key greifen Skripte und Anwendungen auf die API zu.

Entwicklereinstellungen mit Registerkarte API Keys, Zähler API Nutzung und Liste der Keys

API Key erstellen

Öffnen Sie Einstellungen und wählen Sie in der Gruppe Erweiterte Einstellungen den Eintrag Entwickler.
Wählen Sie in der Registerkarte API Keys Ersten API Key erstellen. Sind schon Keys vorhanden, steht unten rechts Neuen API Key erstellen.
Tragen Sie im Dialog Neuen API Key erstellen einen Namen ein, zum Beispiel das System, das den Key nutzt. Bleibt das Feld leer, vergibt Auftrag One einen Namen. Der Name darf höchstens 64 Zeichen haben.
Ergänzen Sie optional eine Beschreibung mit bis zu 512 Zeichen.
Wählen Sie Key erstellen. Die App bestätigt mit „API Key wurde erfolgreich generiert“.

Berechtigungsbereiche oder ein Ablaufdatum stellen Sie hier nicht ein. Die Liste zeigt je Key das Ablaufdatum als Gültig bis, abgelaufene Keys als Abgelaufen.

Key kopieren und verwenden

In der Liste ist der Key bis auf die ersten vier Zeichen verdeckt. Ein Klick auf das Feld zeigt ihn vollständig, das Kopiersymbol daneben legt ihn in die Zwischenablage („API Key wurde in die Zwischenablage kopiert“). Der Key bleibt in der Liste abrufbar, er wird nicht nur einmal angezeigt. Wie Sie ihn senden, steht unter API & Integrationen.

API Key entfernen

Wählen Sie beim Key Entfernen.
Bestätigen Sie im Dialog Token wirklich löschen? mit Token löschen.

Anwendungen und Skripte, die den Key nutzen, verlieren danach den Zugriff. Das lässt sich nicht rückgängig machen. Einen Key tauschen Sie, indem Sie zuerst einen neuen erstellen, Ihre Anwendungen umstellen und dann den alten entfernen; eine eigene Funktion zum Erneuern gibt es nicht.

Verbrauch und Limit

Der Zähler API Nutzung zeigt die verbrauchten Aufrufe im Verhältnis zum Kontingent Ihres Plans. Ist das Kontingent erreicht, erscheint „Limit für API Calls erreicht“ und die Schaltflächen zum Erstellen sind deaktiviert.

Wer darauf zugreifen kann

Der Eintrag Entwickler erscheint nur für Administratoren und Organisatoren und ist im Menü ab dem Plan Team freigeschaltet. Die Keys gehören der Organisation, nicht einer einzelnen Person.