API i webhooki
Połącz profil z własnymi narzędziami: klucze z uprawnieniami i webhooki (PRO+).
API pozwala połączyć profil z własnymi narzędziami: nakładkami na stream, arkuszami, botami czy systemem sprzedaży. Klucze tworzysz w zakładce „API i webhooki”.
- Każdy klucz ma osobne uprawnienia dla kategorii (profil, linki, statystyki, wsparcia, wiadomości, status LIVE i webhooki).
- Webhooki wysyłają zdarzenia (np. nowe wsparcie, opłacone zamówienie, start transmisji) na Twój serwer z podpisem HMAC i ponawiają nieudane dostawy.
- Dziennik zapytań i historia dostaw pomagają znaleźć błędy w integracji.
Do czego się przydaje
- Własna nakładka albo bot na czacie, który reaguje na nowe wsparcia w chwili ich opłacenia.
- Arkusz albo system księgowy, do którego podłączasz potwierdzenia wpłat (webhook).
- Automatyczna zmiana linków lub statusu LIVE z Twojego narzędzia do streamowania.
- Weryfikacja kluczy licencyjnych w Twojej aplikacji (opis w artykule Klucze licencyjne).
Kategorie uprawnień
| Kategoria | Co obejmuje |
|---|---|
| Profil | Nazwa, opis, adres, plan; zapis: nazwa, opis, przycisk wiadomości |
| Linki | Lista linków; zapis: dodawanie, zmiana, kolejność, usuwanie |
| Statystyki | Odsłony, kliknięcia, źródła, urządzenia, ruch na żywo |
| Wsparcia | Historia, podsumowania, cel; zapis: moderacja, zmiana celu |
| Wiadomości | Skrzynka wiadomości; zapis: oznaczanie, usuwanie |
| Status LIVE | Status transmisji; zapis: włączanie i wyłączanie LIVE |
| Webhooki | Lista i historia dostaw; zapis: dodawanie, zmiana, test |
Bezpieczeństwo kluczy
- Pełny klucz zobaczysz tylko raz, przy tworzeniu. Przechowuj go jak hasło, poza kodem publikowanym w internecie.
- Nadawaj kluczowi tylko te uprawnienia, których potrzebuje, i ogranicz go do adresów IP Twojego serwera, jeśli to możliwe.
- Sprawdzaj podpis każdego webhooka. Gdy klucz wycieknie, usuń go w panelu i utwórz nowy.
Dokumentacja API OpenAPI 3.1 (JSON)
W panelu: API
Panel → Ustawienia → API
Klucze API dają Twoim narzędziom dostęp do wybranych danych profilu. Każdy klucz ma własne uprawnienia, a webhooki powiadamiają Twój serwer o zdarzeniach od razu, bez odpytywania.
Twórz osobny klucz dla każdego narzędzia, z najmniejszymi potrzebnymi uprawnieniami. Klucz unieważnisz w każdej chwili, bez wpływu na pozostałe.
Webhook to adres Twojego serwera, na który wysyłamy zdarzenia (POST, JSON) z podpisem HMAC SHA-256. Nieudane dostawy ponawiamy automatycznie.
Przewodnik opisuje działanie panelu. Treści dotyczące danych osobowych i podatków mają charakter informacyjny i nie są poradą prawną.