Uwierzytelnianie
API SentiSnap wykorzystuje klucze API do uwierzytelniania żądań.
Uzyskiwanie klucza API
- Zaloguj się do panelu SentiSnap
- Przejdź do Ustawienia > Klucze API
- Kliknij Utwórz klucz API
- Nadaj kluczowi opisową nazwę
- Wybierz uprawnienia (scopes), których potrzebujesz
- Skopiuj swój klucz — zostanie wyświetlony tylko raz!
Używanie klucza API
Dołącz swój klucz API w nagłówku Authorization:
curl -X GET "https://public-api.sentisnap.com/v1/surveys"
-H "Authorization: Bearer YOUR_TOKEN_HERE"Format klucza API
Klucze API mają następujący format:
sk_live_XXXXXX_YYYYYYYYYYYYYYYYYYYYYYYYsk_live_— prefiks wskazujący na klucz produkcyjnyXXXXXX— identyfikator Twojego zespołuYYYY...— unikalny losowy ciąg znaków
Uprawnienia (Scopes)
Klucze API można tworzyć z ograniczonymi uprawnieniami:
| Uprawnienie | Opis |
|---|---|
surveys:read | Odczyt metadanych i struktury ankiet |
responses:read | Odczyt danych odpowiedzi |
responses:export | Eksport odpowiedzi do CSV/JSON |
analytics:read | Dostęp do analityki i wniosków |
webhooks:read | Przeglądanie subskrypcji webhooków |
webhooks:write | Tworzenie i zarządzanie webhookami |
* | Pełny dostęp (wszystkie uprawnienia) |
Zalecenia bezpieczeństwa
- Nigdy nie udostępniaj publicznie swojego klucza API ani nie dodawaj go do systemu kontroli wersji
- Używaj zmiennych środowiskowych do przechowywania klucza API
- Twórz klucze z minimalnymi wymaganymi uprawnieniami
- Regularnie rotuj swoje klucze
- Natychmiast unieważniaj nieużywane klucze
