Skip to main content
DELETE
Widerruft einen Management-API-Schlüssel dauerhaft. Wie das Erstellen eines Tokens befindet sich dies auf dem regulären Scanova-API-Host (qcg-api.scanova.io) und wird mit Ihrem normalen Dashboard-OAuth-Access-Token authentifiziert — nicht mit dem Schlüssel, den Sie löschen.

​
Anfrage

​
string
erforderlich
Der vollständige Schlüsselwert, der bei der Erstellung des Tokens zurückgegeben wurde (keine numerische ID).

​
Verhalten

  • Ein erfolgreiches Entfernen gibt 204 No Content mit leerem Body zurück.
  • Einmal gelöscht, authentifiziert der Schlüssel sofort nicht mehr am Daten-Host — alle laufenden oder nachfolgenden Anfragen mit ihm erhalten 401.
  • Sie können nur einen Schlüssel löschen, den Sie selbst besitzen (oder, bei einem geteilten Benutzer, einen Schlüssel, den dieser geteilte Benutzer erstellt hat).
Das Löschen prüft außerdem erneut die Plan-Quota anhand eines environment-Werts, standardmäßig sandbox, falls Sie keinen angeben — dieselbe Regel, die auf der Seite Token erstellen beschrieben ist. Dies spielt in der Praxis selten eine Rolle, da Pläne, die Zugriff auf die Management API gewähren, dies typischerweise über alle Environments hinweg tun — geben Sie aber explizit ?environment=live an, wenn Sie beim Löschen eines Live-Environment-Schlüssels unerwartet auf 401 stoßen.
Es gibt keinen “deaktivieren”- oder “pausieren”-Zustand — das Entfernen ist sofort und dauerhaft. Wenn Sie einen Schlüssel nur vorübergehend außer Betrieb setzen möchten, löschen Sie ihn nicht; erstellen Sie stattdessen einen neuen Schlüssel und verwenden Sie den alten nicht mehr, oder stimmen Sie sich mit der ihn nutzenden Integration ab, bevor Sie ihn löschen.

​
Verwandte Themen

  • Management-API-Übersicht — die Zwei-Host-Auth-Architektur, zu der dieser Endpunkt gehört.
  • Ein API-Token erstellen — erzeugen Sie einen Ersatzschlüssel und sehen Sie die Auflistungs-/Quota-Regeln, die sich dieser Endpunkt teilt.
  • Nutzungsstatistiken — prüfen Sie die Nutzung eines Schlüssels, bevor Sie entscheiden, ihn zu entfernen.

Autorisierungen

​
Authorization
string
header
erforderlich

Send your Management API key as the raw value of the Authorization header — no "Bearer " or "Token " prefix, and no other characters. Example: Authorization: 401f7ac837da42b97f613d789819ff93537bee6a. A header containing more than one space-separated part is rejected outright. Requests also require the request's Host header to be the management API host (e.g. management.scanova.io) — the same key sent to the regular API host will not authenticate.

Pfadparameter

​
key
string
erforderlich

Antwort

204

Token removed