API rezerwacji strzelnicy – integracja z kasą i CRM

Chcesz, żeby kasa w recepcji, system CRM albo aplikacja mobilna mogły sprawdzić rezerwacje strzelnicy dla danego gościa? Od teraz możesz to zrobić bez ręcznego zaglądania do panelu – wystarczy klucz API i proste zapytanie do systemu.

Co nowego?

• Klucze API – w panelu klubu (Strzelnica) pojawiła się sekcja „Klucze API – rezerwacje strzelnicy”. Generujesz tam klucz, przekazujesz go do swojego systemu (kasy, CRM), a ten może pobierać listę rezerwacji dla wybranego użytkownika.
• Trzy sposoby identyfikacji strzelca – zapytanie może szukać po ID użytkownika, adresie e-mail albo kodzie zewnętrznego systemu (pole w Karcie strzelca). Dzięki temu integracja działa zarówno z eWZSS, jak i z numeracją z kasy czy CRM.
• Filtrowanie po dacie – można ograniczyć wynik do rezerwacji z wybranego przedziału (np. tylko dzisiaj albo konkretna godzina). Daty są opcjonalne – można podać tylko „od”, tylko „do” lub obie.
• Przejrzyste błędy – każda odpowiedź błędu ma stały kod (np. brak klucza, nieprawidłowy klucz, przekroczony limit). Ułatwia to obsługę po stronie kasy czy CRM (np. wyświetlenie odpowiedniego komunikatu).
• Limity – na jeden klucz API przypada 30 zapytań na minutę; w jednej odpowiedzi zwracane jest maksymalnie 25 ostatnich rezerwacji. W typowym użyciu (np. sprawdzenie rezerwacji przy wizycie) to wystarczy.
• Tester i dokumentacja – na stronie z kluczami API znajdziesz „Wypróbuj API”: wpisujesz klucz, wybierasz parametr (e-mail, ID lub kod zewnętrzny), podajesz wartość i od razu widzisz odpowiedź oraz gotowy kod PHP do skopiowania. Pełna dokumentacja (parametry, kody błędów, limity) jest w dziale pomocy / dokumentacji.

Jak skonfigurować?

1. Wejdź w panel klubu → Strzelnica → Klucze API rezerwacji (w menu po lewej).
2. Wygeneruj klucz – wpisz nazwę (np. „Kasa recepcji” lub „Integracja CRM”), kliknij „Generuj klucz”.
3. Skopiuj klucz – wyświetli się tylko raz. Wklej go w bezpiecznym miejscu (np. konfiguracja kasy lub CRM). Po zamknięciu okna nie zobaczysz go ponownie bez „Regeneruj i pokaż klucz” (wtedy stary klucz przestanie działać).
4. Przekaż klucz do systemu zewnętrznego – programista lub dostawca kasy/CRM ustawi ten klucz w konfiguracji (nagłówek Authorization: Bearer lub X-Api-Key). Adres zapytania to:
   GET /api/shooting-range/reservations?user_id=... (albo email=... lub external_code=...).
5. Opcjonalnie: kod zewnętrzny – jeśli kasa/CRM identyfikuje strzelca swoim numerem, w Karcie strzelca (popup z listy strzelców) w sekcji „Dane wewnętrzne” możesz uzupełnić pole „Kod zewnętrznego systemu”. W zapytaniu API używa się wtedy parametru external_code=TenKod.

Na stronie kluczy API możesz w każdej chwili unieważnić klucz (np. po zmianie dostawcy kasy) albo wygenerować nowy i zastąpić stary.

FAQ

Czy mogę mieć kilka kluczy API?
Tak. Możesz np. osobny klucz dla kasy i osobny dla CRM – każdy ma swój limit 30 zapytań na minutę.

Co jeśli przekroczymy limit 30 zapytań na minutę?
System zwróci błąd z kodem RATE_LIMIT_EXCEEDED. Wtedy trzeba odczekać chwilę lub zoptymalizować częstotliwość odpytywania (np. cache po stronie kasy).

Zwracane są wszystkie rezerwacje użytkownika?
W jednej odpowiedzi – maksymalnie 25 ostatnich (po dacie). Dla typowego sprawdzenia „czy ma rezerwację dziś” to wystarczy. Można zawęzić wynik parametrami date_from i date_to.

Integracja strzelnicy z kasą i CRM w jednym miejscu – bez ręcznego przepisywania rezerwacji.