Testowanie adresów URL callback Cams lokalnie za pomocą ngrok
Zanim przeniesiesz integrację na środowisko produkcyjne, możesz przetestować callbacki Cams API bezpośrednio na swoim komputerze deweloperskim, korzystając z narzędzia tunelowania. Ten przewodnik krok po kroku przeprowadzi Cię przez konfigurację.
Dlaczego potrzebujesz tunelu
Żądania callback i webhook pochodzą z platformy Cams przez internet. Lokalna aplikacja działająca na Twoim komputerze nie może bezpośrednio odbierać tych żądań, ponieważ znajduje się za zaporą sieciową lub siecią NAT.
Usługa tunelowania tworzy bezpieczny publiczny punkt końcowy, który przekazuje przychodzące żądania do Twojej lokalnej aplikacji.
Korzyści
- Testowanie callbacków przed wdrożeniem
- Debugowanie payloadów webhook w czasie rzeczywistym
- Weryfikacja obsługi żądań lokalnie
- Skrócenie czasu developmentu i wdrożenia
Zalecane narzędzia tunelowania

Konfiguracja ngrok (zalecane)
Instalacja
- Odwiedź https://ngrok.com
- Pobierz odpowiednią wersję dla swojego systemu operacyjnego.
- Wypakuj i zainstaluj plik wykonywalny.
- Utwórz bezpłatne konto (opcjonalnie, ale zalecane).
- Wygeneruj AuthToken.
- Skonfiguruj swój AuthToken.
ngrok config add-authtoken YOUR_AUTHTOKEN
Uruchomienie tunelu
Jeśli ngrok jest już skonfigurowany:
ngrok http 3000
Zamień 3000 na port swojej aplikacji.
Przykładowe dane wyjściowe
Forwarding https://abc123.ngrok-free.app -> http://localhost:3000
Twoja aplikacja jest teraz dostępna za pośrednictwem publicznego adresu URL HTTPS.
Alternatywa: użyj narzędzia do testowania callbacków Cams
Możesz także skorzystać z narzędzia do testowania callbacków udostępnianego przez Cams.
- Zainstaluj i rozpakuj narzędzie, korzystając z poniższego linku.
https://developer.camsbiometrics.com/setup/ngrok-helper-kit.rar - Edytuj plik
app.properties. - Skonfiguruj:
ngrok.auth.token=
ngrok.tunnel.url= - Uruchom:
check_ngrok.bat
Narzędzie automatycznie nawiąże tunel i uprości lokalne testowanie callbacków.
Konfiguracja integracji callback
Krok 1: Uruchom swoją lokalną aplikację
Krok 2: Uruchom tunel
Krok 3: Przetestuj callback
Wywołaj przykładowe zdarzenie testowe i sprawdź następujące elementy:
- Twoja aplikacja odbiera żądanie callback.
- Payloady żądań są przetwarzane poprawnie.
- W logach aplikacji nie pojawiają się błędy.
- Żądania są widoczne w panelu tunelu.
Dobre praktyki
- Używaj adresów URL callback HTTPS, kiedy tylko to możliwe.
- Utrzymuj tunel aktywny podczas testów.
- Sprawdzaj logi aplikacji pod kątem walidacji żądań.
- Upewnij się, że Twój punkt końcowy zwraca oczekiwane kody odpowiedzi HTTP.
- Przetestuj scenariusze obsługi błędów przed przeniesieniem na środowisko produkcyjne.
Ważne uwagi
- Bezpłatne adresy URL ngrok zmieniają się za każdym razem, gdy tunel zostanie ponownie uruchomiony.
- Płatne plany ngrok obsługują zarezerwowane domeny i niestandardowe subdomeny.
- Tunele tymczasowe powinny być używane wyłącznie do celów deweloperskich i testowych.
Podsumowanie
Udostępnianie lokalnego serwera za pomocą usługi tunelowania to najszybszy sposób na przetestowanie adresu URL callback przed wdrożeniem aplikacji. Niezależnie od tego, czy używasz ngrok, Cloudflare Tunnel, czy localhost.run, proces ten pozwala odbierać żądania callback w czasie rzeczywistym i weryfikować integrację w lokalnym środowisku deweloperskim.
Postępowanie zgodnie z powyższymi krokami pomoże zapewnić płynne przejście od developmentu do wdrożenia produkcyjnego.