Uwierzytelnianie
Klucze API organizacji i nagłówek X-API-Key.
Każde żądanie musi zawierać klucz API w nagłówku X-API-Key:
curl https://app.aftertalk.co/api/v1/projects \
-H "X-API-Key: at_live_abc12345_..."Klucze należą do organizacji
Właścicielem klucza jest Twoja organizacja, a nie osoba, która go utworzyła. Integracja działa dalej, nawet gdy administrator, który ją skonfigurował, zmieni rolę lub odejdzie z firmy.
Klucz może odczytywać i zapisywać dane we wszystkich projektach swojej organizacji, a zużycie jest rozliczane w ramach planu organizacji.
Tworzenie klucza
W aplikacji przejdź do Organizacja → Ustawienia → Klucze API i utwórz klucz. Musisz mieć rolę właściciela lub administratora organizacji. Pełny klucz jest wyświetlany tylko raz, podczas tworzenia — przechowuj go w bezpiecznym miejscu; później widoczny jest wyłącznie jego prefiks.
Klucze wyglądają tak:
at_live_<8-char id>_<secret>Pierwsza część identyfikuje klucz, druga jest sekretem. Podczas tworzenia możesz opcjonalnie ustawić datę wygaśnięcia, a w dowolnym momencie dezaktywować lub usunąć klucz — obie operacje działają od razu.
Czego klucz nie może zrobić
Klucze służą do automatyzacji pracy w Twojej organizacji, więc kilka rzeczy pozostaje poza ich zasięgiem:
- Tworzenie kluczy API i zarządzanie nimi (żaden klucz nie może wygenerować innego klucza)
- Usuwanie projektu lub rozmowy
- Rozliczenia, konto, członkostwo w organizacji i operacje administracyjne
- Wszystko, co wymaga zalogowanej sesji lub 2FA
Wywołane z kluczem API zwracają 401.
Bezpieczeństwo kluczy
Klucz pozwala odczytywać i zmieniać wszystko w projektach Twojej organizacji — chroń go jak hasła administratora. Trzymaj go po stronie serwera i nigdy nie umieszczaj go w aplikacji przeglądarkowej, w aplikacji mobilnej ani w publicznym repozytorium.
Jeśli klucz wycieknie, usuń go w sekcji Organizacja → Ustawienia → Klucze API; żądania z jego użyciem natychmiast przestaną działać. Twórz osobne klucze dla każdej integracji, aby móc unieważnić jeden, nie przerywając działania pozostałych.