Testarea URL-urilor de callback Cams local cu ngrok
Înainte de a vă muta integrarea în producție, puteți testa callback-urile Cams API direct pe computerul de dezvoltare, folosind un instrument de tunelare. Acest ghid vă parcurge pas cu pas configurarea.
De ce aveți nevoie de un tunel
Cererile de callback și webhook provin de pe platforma Cams prin internet. O aplicație locală care rulează pe computerul dumneavoastră nu poate primi direct aceste cereri, deoarece se află în spatele unui firewall sau al unei rețele NAT.
Un serviciu de tunelare creează un punct final public securizat, care redirecționează cererile primite către aplicația dumneavoastră locală.
Beneficii
- Testarea callback-urilor înainte de implementare
- Depanarea payload-urilor webhook în timp real
- Validarea procesării cererilor local
- Reducerea timpului de dezvoltare și implementare
Instrumente de tunelare recomandate

Configurarea ngrok (recomandat)
Instalare
- Accesați https://ngrok.com
- Descărcați versiunea potrivită pentru sistemul de operare.
- Extrageți și instalați fișierul executabil.
- Creați un cont gratuit (opțional, dar recomandat).
- Generați AuthToken.
- Configurați AuthToken-ul.
ngrok config add-authtoken YOUR_AUTHTOKEN
Pornirea unui tunel
Dacă ngrok este deja configurat:
ngrok http 3000
Înlocuiți 3000 cu portul aplicației dumneavoastră.
Exemplu de ieșire
Forwarding https://abc123.ngrok-free.app -> http://localhost:3000
Aplicația dumneavoastră este acum accesibilă prin URL-ul public HTTPS.
Alternativă: utilizați instrumentul Cams de testare a callback-urilor
Puteți utiliza și utilitarul de testare a callback-urilor furnizat de Cams.
- Instalați și dezarhivați instrumentul folosind următorul link.
https://developer.camsbiometrics.com/setup/ngrok-helper-kit.rar - Editați fișierul
app.properties. - Configurați:
ngrok.auth.token=
ngrok.tunnel.url= - Rulați:
check_ngrok.bat
Utilitarul va stabili automat tunelul și va simplifica testarea locală a callback-urilor.
Configurarea integrării callback
Pasul 1: Porniți aplicația locală
Pasul 2: Porniți tunelul
Pasul 3: Testați callback-ul
Declanșați un eveniment de test și verificați următoarele:
- Aplicația dumneavoastră primește cererea de callback.
- Payload-urile cererilor sunt procesate cu succes.
- Nu apar erori în jurnalele aplicației.
- Cererile sunt vizibile în panoul tunelului.
Bune practici
- Utilizați URL-uri de callback HTTPS ori de câte ori este posibil.
- Mențineți tunelul activ pe durata testării.
- Verificați jurnalele aplicației pentru validarea cererilor.
- Verificați dacă punctul final returnează codurile de răspuns HTTP așteptate.
- Testați scenariile de gestionare a erorilor înainte de trecerea în producție.
Note importante
- URL-urile ngrok gratuite se schimbă de fiecare dată când tunelul se repornește.
- Planurile ngrok plătite acceptă domenii rezervate și subdomenii personalizate.
- Tunelurile temporare trebuie utilizate doar în scopuri de dezvoltare și testare.
Concluzie
Expunerea serverului local printr-un serviciu de tunelare este cea mai rapidă modalitate de a testa URL-ul de callback înainte de implementarea aplicației. Indiferent dacă utilizați ngrok, Cloudflare Tunnel sau localhost.run, procesul vă permite să primiți cereri de callback în timp real și să validați integrarea într-un mediu local de dezvoltare.
Urmarea pașilor de mai sus vă va ajuta să asigurați o tranziție fluidă de la dezvoltare la implementarea în producție.