Tokeny API i webhooki
Zaktualizowano 14 października 2026
Dostępność
API i webhooki są częścią planów, które je zawierają (zob. stronę z cennikiem). Jeśli Twój plan ich nie ma, strona API i webhooki to pokaże. Otworzyć ją mogą tylko właściciele i administratorzy.
Utwórz token
- Otwórz API i webhooki i znajdź Tokeny.
- Wpisz Nazwę tokenu, np. „nasze CRM”. Domyślnie token może tylko czytać. Zaznacz Może dodawać strony i uruchamiać sprawdzenia, jeśli narzędzie ma zapisywać.
- Kliknij Utwórz token i od razu go skopiuj: pokazuje się tylko raz. Jeśli go zgubisz, usuń token i utwórz nowy.
Usuwaj tokeny, z których już nie korzystasz; lista pokazuje, kiedy każdy był użyty ostatnio.
Wywołuj API
Adres bazowy i link do opisu OpenAPI są w bloku Jak zacząć. Przekaż token w nagłówku:
curl -H "Authorization: Bearer $TOKEN" -H "Accept: application/json" https://pandus.online/api/v1/sites
Przez API możesz wyświetlać strony, dodawać je i usuwać, uruchamiać sprawdzenie oraz pobierać sprawdzenie, jego raport i PDF. Token może wysyłać do 60 żądań na minutę.
Webhooki
Webhook informuje Twój system, gdy coś się wydarzy, więc nie musisz pytać. Kliknij Dodaj webhook, wpisz adres https i wybierz zdarzenia: zakończone sprawdzenie (scan.completed) i nowe znalezione problemy (issues.new). Zespół może mieć do pięciu adresów.
Każda wiadomość jest podpisana. W nagłówku Pandus-Signature są czas i podpis HMAC-SHA256 wykonany Twoim Sekretem podpisu. Sprawdź go, zanim zaufasz wiadomości.
Wyślij test sprawdza adres. Dziennik dostarczeń pokazuje każdą próbę. Nieudana wiadomość jest ponawiana do sześciu razy w ciągu około doby; możesz też ponowić ją ręcznie. Adres, który stale zawodzi, jest wyłączany po 20 porażkach z rzędu. Adresy prowadzące do sieci prywatnej są odrzucane.