Skip to main content
Die Management API ist die programmatische Schnittstelle für alles, was Sie im Scanova-Dashboard tun können: QR-Codes erstellen und aktualisieren, Ordner und Tags verwalten, Leads und Formulareinsendungen lesen, Analysen abrufen sowie geteilte Benutzer und Rollen verwalten. Sie läuft auf einem eigenen Host, getrennt von der übrigen Scanova-API-Oberfläche, mit einem eigenen Authentifizierungsschema.
Diese Seite behandelt die Architektur, die für jeden Management-API-Endpunkt gilt. Die vollständige Liste der Endpunkte finden Sie auf den am Ende dieser Seite verlinkten Unterseiten.

​
Erste Schritte

1

Einen Management-API-Schlüssel erstellen

Erstellen Sie, während Sie im Scanova-Dashboard eingeloggt sind, einen Schlüssel über API-Schlüssel erstellen & verwalten. Wählen Sie beim Erstellen ein environment — sandbox, live, zapier oder mcp — aus; diese Wahl ist für diesen Schlüssel dauerhaft und bestimmt, welche Plan-Quota bei jeder Anfrage geprüft wird, die der Schlüssel stellt (siehe unten).
2

Den rohen Wert des Schlüssels speichern

Der beim Erstellen zurückgegebene Schlüsselwert ist das einzige Mal, dass Sie ihn vollständig sehen — speichern Sie ihn sicher. Es gibt keinen “Anzeigen”-Endpunkt im Nachhinein.
3

Die Daten-Endpunkte aufrufen

Senden Sie den Schlüssel als rohen Authorization-Header-Wert an api.scanova.io, zum Beispiel GET /qr/, um Ihre QR-Codes aufzulisten.

​
Plan-Quota

Jede Anfrage an einen Daten-Endpunkt prüft eine Plan-Quota, die an das environment des Schlüssels gebunden ist:
Wenn eine Anfrage an den Daten-Host 401 mit der Meldung “Your plan does not have management API quota” zurückgibt (oder den Zapier-/MCP-spezifischen Entsprechungen), gewährt Ihr Plan diese Quota nicht. Derzeit umfasst der kanonische Pro-Plan keinen Zugriff auf die Management API — nur Free Trial, Enterprise und Internal-Pläne tun dies. Kontaktieren Sie support@scanova.io, wenn Sie glauben, dass Ihr Konto darauf zugreifen können sollte.
sandbox ist nur ein Label- und Quota-Konzept — es ist keine isolierte Testumgebung. Ein mit environment: sandbox erstellter Schlüssel liest und schreibt dieselben echten QR-Codes, Ordner und Leads wie ein live-Schlüssel. Verlassen Sie sich nicht darauf für Wegwerf-Testdaten.
Ein zapier-/mcp-Schlüssel authentifiziert zusätzlich nur dann, wenn der User-Agent-Header des aufrufenden Clients zu seinem Environment passt — ein zapier-Schlüssel weist Anfragen zurück, sofern nicht User-Agent: zapier gesendet wird, und ebenso für mcp. Dies wird unabhängig von der obigen Quota-Prüfung durchgesetzt.

​
Was dieser Abschnitt enthält

QR-Codes auflisten

GET /qr/ — der zentrale Daten-Endpunkt, mit dem die meisten Integrationen beginnen.

Einen QR-Code erstellen

POST /qr/ — der zentrale Daten-Endpunkt, mit dem die meisten Integrationen beginnen.
Die vollständige Liste finden Sie in der Seitenleiste, einschließlich Abrufen/Aktualisieren/Löschen eines einzelnen QR-Codes, Herunterladen von QR-Bildern und Durchsuchen des Papierkorbs.

​
Verwandte Themen