Przegląd
Klucze API pozwalają zintegrować Bugalou z zewnętrznymi systemami i własnymi aplikacjami. Służą do uwierzytelniania żądań do wszystkich REST API Bugalou — niezależnie od tego, czy wysyłasz szablony WhatsApp, zarządzasz zamówieniami, czy śledzisz faktury. Przejdź do Ustawienia organizacji → API i integracje. API jest dostępne w planie Enterprise.
Tworzenie klucza API
- Kliknij „Utwórz klucz API” w prawym górnym rogu
- Wpisz nazwę klucza (np. „Production API”, „Staging Environment”)
- Kliknij „Utwórz klucz”
- Pełny klucz jest wyświetlany tylko raz na zielonej karcie — skopiuj go od razu! Kliknij „Kopiuj”, a potem „Zapisałem klucz”
Ważne: pełny klucz jest wyświetlany tylko raz. Po potwierdzeniu widoczny jest już tylko prefiks (bg_live_••••••••).
Zarządzanie kluczami
Każda karta klucza API pokazuje:
- Nazwę — wybraną przez ciebie nazwę klucza
- Plakietkę statusu — „Aktywny” (zielona) lub „Wyłączony” (szara)
- Prefiks — zamaskowany klucz:
bg_live_•••••••• - Utworzono — data utworzenia
- Ostatnie użycie — kiedy klucz został ostatnio użyty do wywołania API
Akcje na kluczach
- Wyłącz / włącz — tymczasowo wyłącz klucz bez usuwania go
- Unieważnij — trwale usuń klucz (z oknem potwierdzenia)
Uwierzytelnianie
Dołączaj klucz API do każdego żądania na jeden z dwóch sposobów:
X-API-Key: bg_live_your_key_here— własny nagłówekAuthorization: Bearer bg_live_your_key_here— token Bearer
Obie metody działają we wszystkich punktach końcowych API.
Dobre praktyki bezpieczeństwa
- Nigdy nie umieszczaj klucza API w publicznych repozytoriach kodu
- Przechowuj klucze w aplikacjach w zmiennych środowiskowych
- Twórz osobne klucze dla środowiska produkcyjnego i testowego
- Wyłączaj lub unieważniaj klucze, których już nie potrzebujesz
- Okresowo zmieniaj klucze — utwórz nowy klucz, zaktualizuj integracje, a potem unieważnij stary
Dostępne API
Mając klucz API, możesz korzystać z następujących REST API:
- API szablonów WhatsApp — programowe wysyłanie wiadomości z szablonów
- API zamówień i e-commerce — zarządzanie zamówieniami ze sklepów i własnych systemów
- API faktur i płatności — śledzenie faktur, płatności i danych finansowych