Authentifizierung
Die Sentisnap-API verwendet API-Schlüssel zur Authentifizierung von Anfragen.
API-Schlüssel erhalten
- Melden Sie sich in Ihrem Sentisnap-Dashboard an
- Gehen Sie zu Einstellungen > API-Schlüssel
- Klicken Sie auf API-Schlüssel erstellen
- Geben Sie Ihrem Schlüssel einen aussagekräftigen Namen
- Wählen Sie die Berechtigungen (Scopes), die Sie benötigen
- Kopieren Sie Ihren Schlüssel — er wird nur einmal angezeigt!
API-Schlüssel verwenden
Fügen Sie Ihren API-Schlüssel in den Authorization-Header ein:
curl -X GET "https://public-api.sentisnap.com/v1/surveys"
-H "Authorization: Bearer YOUR_TOKEN_HERE"Format des API-Schlüssels
API-Schlüssel haben folgendes Format:
sk_live_XXXXXX_YYYYYYYYYYYYYYYYYYYYYYYYsk_live_— Präfix für einen ProduktionsschlüsselXXXXXX— Ihre Team-KennungYYYY...— einzigartiger zufälliger String
Berechtigungen (Scopes)
API-Schlüssel können mit eingeschränkten Berechtigungen erstellt werden:
| Berechtigung | Beschreibung |
|---|---|
surveys:read | Metadaten und Struktur von Umfragen lesen |
responses:read | Antwortdaten lesen |
responses:export | Antworten als CSV/JSON exportieren |
analytics:read | Zugriff auf Analytik und Insights |
webhooks:read | Webhook-Abonnements anzeigen |
webhooks:write | Webhooks erstellen und verwalten |
* | Vollzugriff (alle Berechtigungen) |
Sicherheitsempfehlungen
- Teilen Sie Ihren API-Schlüssel niemals öffentlich und committen Sie ihn nicht in die Versionsverwaltung
- Verwenden Sie Umgebungsvariablen zum Speichern Ihres API-Schlüssels
- Erstellen Sie Schlüssel mit den minimal erforderlichen Berechtigungen
- Rotieren Sie Ihre Schlüssel regelmäßig
- Widerrufen Sie ungenutzte Schlüssel sofort