Ihren Screeb API-Schlüssel abrufen
Finden Sie den API-Schlüssel Ihres Workspace, senden Sie damit Daten und Releases aus Ihrem Backend an Screeb und setzen Sie ihn zurück, falls er offengelegt wurde.
Diese Seite wurde automatisch übersetzt. Maßgeblich ist die englische Version.
Mit dem API-Schlüssel des Workspace sprechen Ihre eigenen Server mit Screeb, ganz ohne Tag oder mobiles SDK. Jeder Workspace hat genau einen Schlüssel.
Bevor Sie beginnen
Abschnitt betitelt „Bevor Sie beginnen“- Die Seite Screeb API und das Zurücksetzen des Schlüssels sind Mitgliedern mit der Rolle Admin in der Organisation vorbehalten.
- Ein Editor oder Admin des Workspace kann den Schlüssel unter Releases kopieren, siehe Schlüssel zurücksetzen. Ein Analyst kann ihn nicht sehen.
- Der Schlüssel ist ein Geheimnis: Wer ihn besitzt, kann Daten an Ihren Workspace senden. Bewahren Sie ihn auf Ihren Servern auf, niemals im Code Ihrer Website oder App.
Schlüssel kopieren
Abschnitt betitelt „Schlüssel kopieren“- Klicken Sie in der Workspace-Seitenleiste auf Einstellungen und dann unter Daten & Bereitstellung auf Screeb API.
- Klicken Sie unter Workspace-API-Schlüssel auf Kopieren.
- Geben Sie den Schlüssel über einen sicheren Kanal, etwa Ihren Passwortmanager, an die Entwicklerin oder den Entwickler weiter, die bzw. der die Integration einrichtet.

Der Schlüssel ist nicht die Workspace-ID, die im Installationscode Ihrer Website oder App steht. Diese ID ist öffentlich und identifiziert den Workspace nur gegenüber dem Tag und den SDKs, siehe Screeb auf Ihrer Website oder Web-App installieren.
Schlüssel verwenden
Abschnitt betitelt „Schlüssel verwenden“Ihre Entwickler senden ihn im Header Authorization: Bearer jeder Anfrage an die Screeb API. Damit können sie:
- Nutzerdaten aus Ihrem Backend senden: Nutzereigenschaften, Events, Gruppen sowie Seiten- und Bildschirmaufrufe. Siehe Nutzereigenschaften senden und verwalten und Nutzerereignisse erfassen und verwalten.
- Releases aus Ihrer Deployment-Pipeline protokollieren, siehe Ihre Releases verfolgen.
Die Endpunkte, Payloads und Limits finden Sie in der Screeb API-Referenz.
Einige Integrationen zeigen auf ihrer Seite ein eigenes Token an. Dieses Token ist vom API-Schlüssel des Workspace unabhängig.
Schlüssel zurücksetzen
Abschnitt betitelt „Schlüssel zurücksetzen“Setzen Sie den Schlüssel zurück, wenn er offengelegt wurde oder wenn jemand, der ihn kannte, Ihr Team verlässt.
- Öffnen Sie Releases und klicken Sie auf Releases über die API erstellen. Das Fenster zeigt denselben Schlüssel, mit einer Schaltfläche zum Kopieren für Editoren und Admins des Workspace.
- Klicken Sie auf Zurücksetzen und dann auf Token zurücksetzen. Der neue Schlüssel ersetzt den alten sofort. Nur Admins der Organisation sehen Zurücksetzen.
- Geben Sie den neuen Schlüssel an Ihre Entwickler weiter und aktualisieren Sie jeden Server, jedes Skript und jede Pipeline, die den alten verwendet hat.
Das Zurücksetzen lässt sich nicht rückgängig machen. Jeder Aufruf, der noch den alten Schlüssel verwendet, schlägt mit einem Autorisierungsfehler fehl, bis er den neuen erhält, sowohl bei Nutzerdaten als auch bei Releases.
Das Ergebnis
Abschnitt betitelt „Das Ergebnis“Ihr Backend kann Daten und Releases an Screeb senden, und Sie wissen, wo Sie den Schlüssel bei Bedarf erneuern.
Fehlerbehebung
Abschnitt betitelt „Fehlerbehebung“Die API antwortet mit 401 Unauthorized. Der Schlüssel fehlt, enthält einen Tippfehler oder wurde zurückgesetzt. Kopieren Sie ihn erneut unter Screeb API und prüfen Sie, ob der Header Authorization: Bearer gefolgt vom Schlüssel lautet.
Daten landen im falschen Workspace. Jeder Workspace hat seinen eigenen Schlüssel. Prüfen Sie, ob Sie den Schlüssel des Workspace kopiert haben, den Sie gerade ansehen.