Support Hub/API & Integrations/Prueba local de las URL de callback de Cams con ngrok
Translated from the English article and reviewed by a person. Read the English original
Developer

Prueba local de las URL de callback de Cams con ngrok

Prueba local de las URL de callback de Cams con ngrok

Antes de pasar su integración a producción, puede probar los callbacks de Cams API directamente en su equipo de desarrollo mediante una herramienta de túnel. Esta guía le muestra, paso a paso, cómo realizar la configuración.

Por qué necesita un túnel

Las solicitudes de callback y webhook se originan en la plataforma de Cams a través de internet. Una aplicación local que se ejecuta en su equipo no puede recibir estas solicitudes directamente, ya que se encuentra detrás de un cortafuegos o de una red NAT.

Un servicio de túnel crea un endpoint público seguro que reenvía las solicitudes entrantes a su aplicación local.

Ventajas

  • Probar los callbacks antes de la implementación
  • Depurar las cargas útiles de webhook en tiempo real
  • Validar el manejo de solicitudes en local
  • Reducir el tiempo de desarrollo e implementación

Herramientas de túnel recomendadas

Configuración de ngrok (recomendada)

Instalación

  1. Visite https://ngrok.com
  2. Descargue la versión adecuada para su sistema operativo.
  3. Extraiga e instale el ejecutable.
  4. Cree una cuenta gratuita (opcional, pero recomendado).
  5. Genere un AuthToken.
  6. Configure su AuthToken.
    ngrok config add-authtoken YOUR_AUTHTOKEN

Iniciar un túnel

Si ngrok ya está configurado:
ngrok http 3000
Reemplace 3000 por el puerto de su aplicación.

Ejemplo de salida

Forwarding https://abc123.ngrok-free.app -> http://localhost:3000
Su aplicación ya es accesible a través de la URL HTTPS pública.

Alternativa: use la herramienta de prueba de callbacks de Cams

También puede utilizar la utilidad de prueba de callbacks que ofrece Cams.

  1. Instale y descomprima la herramienta mediante el siguiente enlace.
    https://developer.camsbiometrics.com/setup/ngrok-helper-kit.rar
  2. Edite el archivo app.properties.
  3. Configure:
    ngrok.auth.token=
    ngrok.tunnel.url=
  4. Ejecute:
    check_ngrok.bat

La utilidad establecerá automáticamente el túnel y simplificará la prueba local de callbacks.


Configuración de la integración de callbacks

Paso 1: Inicie su aplicación local
Paso 2: Inicie el túnel
Paso 3: Pruebe el callback
Desencadene un evento de prueba de ejemplo y verifique lo siguiente:

  • Su aplicación recibe la solicitud de callback.
  • Las cargas útiles de la solicitud se procesan correctamente.
  • No aparecen errores en los registros de la aplicación.
  • Las solicitudes son visibles en el panel del túnel.

Buenas prácticas

  • Utilice URL de callback HTTPS siempre que sea posible.
  • Mantenga el túnel activo durante las pruebas.
  • Revise los registros de la aplicación para validar las solicitudes.
  • Verifique que su endpoint devuelve los códigos de respuesta HTTP esperados.
  • Pruebe los escenarios de gestión de errores antes de pasar a producción.

Notas importantes

  • Las URL de ngrok gratuitas cambian cada vez que se reinicia el túnel.
  • Los planes de pago de ngrok admiten dominios reservados y subdominios personalizados.
  • Los túneles temporales solo deben utilizarse con fines de desarrollo y pruebas.

Conclusión

Exponer su servidor local mediante un servicio de túnel es la forma más rápida de probar su URL de callback antes de implementar su aplicación. Ya sea que utilice ngrok, Cloudflare Tunnel o localhost.run, el proceso le permite recibir solicitudes de callback en tiempo real y validar su integración en un entorno de desarrollo local.

Seguir los pasos anteriores ayudará a garantizar una transición fluida del desarrollo a la implementación en producción.

Was this article helpful?