Skip to main content
Diese Seite behandelt die Dashboard-Oberfläche für Management-API-Schlüssel. Das zugrunde liegende Übertragungsformat finden Sie in den technischen Referenzseiten: Create an API token, Remove an API token und den Usage-Endpunkten.

​
Wo Sie es finden

API-Schlüssel befinden sich unter /api/keys, unter Developer → API in der Seitenleiste. Es handelt sich um dieselbe Seite, unabhängig davon, ob Sie null oder mehrere Schlüssel haben — ein Konto ohne Schlüssel sieht statt einer leeren Tabelle eine Erklärung:
API-Keys-Seite mit der Überschrift 'API Keys', einer Schaltfläche Generate API Key, dem Hinweis 'You can create upto 1 API keys' sowie einem Leerzustand-Panel mit dem Titel 'Run Scanova from your own systems' mit drei Vorteilskarten (Full programmatic control, Integrate with your own systems, Automate at scale) und einer Schaltfläche Generate API Key

API-Keys-Seite, live verifiziert bei einem Konto ohne bisherige Schlüssel — beachten Sie den Kontingent-Hinweis des Plans direkt unter der Seitenüberschrift

Der Zugriff auf diese Seite ist an zwei Dinge gebunden: eine Berechtigung (Ansehen oder Verwalten) und ein Plankontingent (MANAGEMENT_API). Gewährt Ihr Plan dieses Kontingent nicht, sehen Sie diese Seite überhaupt nicht — kontaktieren Sie den Support, falls Sie Zugriff auf die Management API in Ihrem Plan erwarten.

​
Einen Schlüssel generieren

Wählen Sie Generate API Key (in der Kopfzeile oder über die entsprechende Schaltfläche im Leerzustand), um den Erstellungs-Drawer zu öffnen:
Create-API-Key-Drawer mit einem Textfeld Name (0/100 Zeichen) und einem auf 'in 1 Month' gesetzten Expiration-Dropdown, mit den Schaltflächen Cancel und Create

Der Drawer Create API Key, live verifiziert

Die Auswahl von Create zeigt sofort den rohen Schlüsselwert in einem einmalig sichtbaren Dialog an:
Der Dialog mit dem erstellten Schlüssel enthält den Text “Copy your API key now. You won’t be able to see it again.” Kopieren Sie ihn sofort — dieses Dokumentationsprojekt hat keinen Screenshot dieses Dialogs veröffentlicht, da er zwangsläufig ein echtes, live gültiges, kopierbares Geheimnis anzeigt.
Wählen Sie bei der Ablaufzeit Never, zeigt der Dialog eine zusätzliche gelbe Warnung, dass ein nie ablaufender Schlüssel mit besonderer Sorgfalt behandelt werden sollte, da er sich nicht von selbst erneuert.

​
Bestehende Schlüssel verwalten

Die Tabelle listet jeden Schlüssel des Kontos auf: Name, einen maskierten API-Key-Wert mit einem Symbol zum Kopieren in die Zwischenablage, Created On, Created By und Expires On (oder “Never”). Das Datum eines abgelaufenen Schlüssels wird in Rot angezeigt.
Der Plan dieses Kontos erlaubt jeweils nur 1 API-Schlüssel — der Hinweis direkt unter der Seitenüberschrift (“You can create upto {limit} API keys”) spiegelt das Kontingent Ihres spezifischen Plans wider, nicht ein plattformweites Limit. Bei einem unbegrenzten Plan erscheint dieser Hinweis gar nicht.

​
Einen Schlüssel widerrufen

Wählen Sie das Papierkorbsymbol am Ende der Zeile eines Schlüssels, um einen Bestätigungs-Drawer zu öffnen, der Name, maskierten Wert, Active/Expired-Badge und Erstellungsdatum des Schlüssels anzeigt. Die Bestätigung widerruft ihn sofort und dauerhaft — genau wie beim Verhalten des Remove-Endpunkts: Es gibt keinen “Pausieren”-Status, und jede bereits laufende Anfrage mit diesem Schlüssel schlägt sofort fehl.
  • Create an API token — die technische Anfrage-/Antwortstruktur hinter dem oben genannten Drawer Generate API Key.
  • Remove an API token — die technische Struktur hinter der oben genannten Widerrufsaktion.
  • API usage dashboard — wo (und derzeit, wo nicht) Sie sehen können, wie stark ein Schlüssel genutzt wurde.