# Partner API: zarządzanie kluczami i webhookami

Canonical: https://staystryk.com/pl/documentation/partner-api/
Language: pl
Updated: 2026-11-12

Tworzysz w STRYK klucze API z dokładnie potrzebnymi uprawnieniami i konfigurujesz webhooki dla Partner API. Endpointy są w portalu deweloperskim.

## Zanim zaczniesz

Potrzebujesz uprawnienia Zarządzaj kanałami. Tylko dzięki niemu zobaczysz wiersz API na stronie Kanały.

Ustal, które obszary integracja ma czytać lub zapisywać. Klucz dostaje tylko te uprawnienia.

Integracja wywołuje Partner API z własnego serwera. Klucza nigdy nie umieszczaj w kodzie przeglądarki ani w aplikacji. Endpointy, parametry i przykłady znajdziesz w Dokumentacji dla deweloperów. Sekcja Uwierzytelnianie i zakresy wyjaśnia, co daje każde uprawnienie.

Webhooki potrzebują odbiorcy z adresem zaczynającym się od https://.

## Otwórz API

Kanały

Wybierz w sekcji Własne połączenia wiersz API z dopiskiem „Klucze API i webhooki“. Otworzy się okno API.

Wybierz zakładkę Klucze API lub Webhooki. Przyciskiem Dokumentacja dla deweloperów w nagłówku okna otworzysz portal deweloperski.

Okno API na zakładce Klucze API z kluczem Strona rezerwacji, jego uprawnieniami, ostatnim użyciem i statusem Aktywny.

Zakładki Klucze API i Webhooki

Klucz z uprawnieniami

Działania dla klucza

## Utwórz klucz API

KanałyAPIKlucze API

Wybierz Utwórz klucz API. Otworzy się okno Utwórz klucz API.

Wpisz Nazwa, na przykład „Strona rezerwacji“.

Przy Uprawnienia wybierz wzór: Tylko odczyt (czytanie wszystkich obszarów), Odczyt i zapis (zapis tam, gdzie to możliwe) albo Niestandardowe. Przy Niestandardowe wybierasz dla każdego obszaru Brak dostępu, Odczyt lub Zapis. Obszary to Hotel i pokoje, Dostępność, Ceny i taryfy, Rezerwacje, Goście, Płatności i Faktury. Zapis obejmuje Odczyt. Faktury są dokumentami fiskalnymi hotelu i przez API można je tylko odczytywać.

Opcjonalnie: otwórz Zaawansowany. Wybierz Wygaśnięcie: Bez wygaśnięcia, 30 dni, 90 dni, 1 rok albo Data (od jutra, najwyżej za trzy lata). Przy Ograniczenie IP wpisz w każdym wierszu adres albo sieć CIDR, najwyżej 20. Puste pole dopuszcza wszystkie adresy. W polu Uwaga zapisujesz wewnętrzną wskazówkę.

Wybierz Utwórz. STRYK pokaże Utworzono klucz API z kluczem i informacją Widoczny tylko teraz.

Skopiuj klucz i zapisz go na przykład w menedżerze haseł. Wybierz Gotowe.

STRYK pokazuje pełny klucz tylko raz. Jeśli go nie zapiszesz, wygeneruj klucz ponownie.

## Zarządzanie kluczami API

KanałyAPIKlucze API

Lista pokazuje dla każdego klucza Nazwa, początek klucza, Uprawnienia, Utworzono, Ostatnio używany, Wygaśnięcie oraz status: Aktywny, Wkrótce wygasa, Odwołane albo Wygasły. Wybierz klucz, aby zobaczyć Uprawnienia, Wygaśnięcie, Dozwolone adresy IP, Limit zapytań (zapytania na minutę), Wykorzystanie, Ostatnie żądania i Historię.

Otwórz w wierszu menu Opcje.

Wybierz Wygeneruj nowy, gdy integracja ma dostać nowy klucz z tymi samymi uprawnieniami. Przy Dotychczasowy klucz wybierz Stary klucz ważny jeszcze 24 h, aby przestawić integrację, albo Unieważnij od razu. Potwierdź przyciskiem Wygeneruj nowy. STRYK pokaże nowy klucz jeden raz.

Wybierz Odwołaj i potwierdź Unieważnić klucz API?, aby natychmiast zablokować klucz. Żądania z tym kluczem STRYK wtedy odrzuca.

## Konfiguracja webhooków

KanałyAPIWebhooki

Webhook wysyła wybrane zdarzenia podpisane przez HTTPS do twoich systemów.

Wybierz Utwórz webhook. Otworzy się okno Nowy webhook.

Wpisz Adres URL odbiorcy, na przykład https://crm.nordlicht.invalid/hooks/stryk. Adres musi zaczynać się od https://.

Opcjonalnie: wpisz Opis, na przykład „Rezerwacje do naszego CRM“.

Wybierz przy Wydarzenia co najmniej jedno: Rezerwacja utworzona, Rezerwacja zmieniona, Rezerwacja anulowana, Gość zmieniony, Dostępność zmieniona, Cena zmieniona, Płatność zmieniona albo Zmieniono status pokoju. Przyciskami Zaznacz wszystko i Wyczyść zaznaczenie wybierasz wszystkie albo żadne.

Wybierz Utwórz webhook. STRYK pokaże Twój sekret podpisu jeden raz.

Zapisz sekret u odbiorcy. Jak odbiorca sprawdza podpis, opisuje dokumentacja deweloperska w sekcji Webhooki i weryfikacja podpisu.

Wybierz webhook, a następnie Wyślij zdarzenie testowe. STRYK zgłasza „Zdarzenie testowe jest dostarczane.“

## Zarządzanie webhookami

Ort: Kanały \> API \> Webhooki, wybierz webhook

Przełącznikiem Doręczanie aktywne wstrzymujesz lub aktywujesz webhook. Wstrzymane webhooki nie dostają zdarzeń. Po aktywacji doręczanie zaczyna się od nowych zdarzeń.

Ostatnie 7 dni, Ostatni sukces i Ostatni błąd pokazują stan. W sekcji Dostawy widzisz każde doręczenie ze Status HTTP i Próby. Przyciskiem Wyślij ponownie powtarzasz doręczenie.

Odnów sekret tworzy nowy sekret. Dotychczasowy pozostaje ważny jeszcze 24 godziny, abyś mógł przestawić odbiorcę.

Przyciskiem Edytuj zmienisz adres i wydarzenia, a przyciskiem Usuń i potwierdzeniem Usunąć webhook? go usuniesz. Protokół doręczeń zostaje zachowany przez 30 dni.

## Tak sprawdzisz wynik

Przy kluczu pojawi się Ostatnio używany z datą, gdy integracja go użyje. Żądania 24 h liczy żądania.

Przy webhooku Ostatnie 7 dni pokazuje „{Zahl} dostarczonych, {Zahl} nieudanych“, a zdarzenie testowe jest widoczne w Dostawy.

## Gdy coś nie działa

„Wybierz co najmniej jedno uprawnienie.“, Żaden obszar nie ma uprawnienia., Wybierz wzór albo przypisz co najmniej jednemu obszarowi Odczyt lub Zapis.

„Wpisz nazwę.“, Brakuje Nazwa., Wpisz nazwę.

„Sprawdź:“ z adresem, Adres w Ograniczenie IP jest nieprawidłowy., Popraw adres albo sieć CIDR. Dozwolone są najwyżej 20 wpisów.

„Wybierz datę od jutra, najwyżej za trzy lata.“, Data wygaśnięcia jest poza dozwolonym zakresem., Wybierz datę od jutra, która jest najwyżej trzy lata od dziś.

„Adres musi zaczynać się od https://.“, Adres URL odbiorcy nie jest adresem HTTPS., Wpisz adres zaczynający się od https://.

„Wybierz co najmniej jedno wydarzenie.“, Webhook nie ma żadnego wydarzenia., Wybierz co najmniej jedno przy Wydarzenia.

Wstrzymany z powodu powtarzających się błędów, Odbiorca nie odpowiada statusem 2xx., Sprawdź, czy odbiorca jest dostępny, i wybierz Aktywuj ponownie.

„Aktywuj webhook, aby wysłać zdarzenie testowe.“, Webhook jest wstrzymany., Aktywuj Doręczanie aktywne i wyślij zdarzenie testowe.

„Nie udało się wczytać wyboru. Zamknij okno i otwórz je ponownie.“, Lista uprawnień i wydarzeń nie została wczytana., Zamknij okno i otwórz je ponownie.

## Z tym wiąże się

Kanały: Wiersz API znajduje się obok portali rezerwacyjnych: Łączenie i monitorowanie kanałów.

Portal deweloperski: endpointy, kody błędów i limity zapytań są w Dokumentacji dla deweloperów.
