Translated from the English article and reviewed by a person. Read the English original
Fix
La URL de callback no recibe datos: lista de comprobación
Si los punches no llegan a tu URL de callback, haz estas comprobaciones en orden.
- ¿El dispositivo llega a Cams? Abre la página Device Status. Si el dispositivo está sin conexión, consulta Why a device shows offline.
- ¿La URL es correcta? Revisa la URL de callback guardada en tu cuenta de API Monitor.
- ¿Tu servidor responde correctamente? Responde siempre con
{"status":"done"}y estado HTTP 200, incluso si falla tu propio procesamiento. Haz el trabajo pesado después, en una cola, para que Cams nunca quede esperando. - ¿El endpoint es accesible desde internet? Usa el puerto 80 (HTTP) o 443 (HTTPS) en producción. El puerto 8123 es solo para pruebas. Permite estos puertos en tu firewall.
- ¿HTTPS está bien configurado? Se admite y se recomienda HTTPS con un certificado SSL válido en el puerto 443. Asegúrate de que el certificado se renueve sin reiniciar el servidor.
- ¿Lees el cuerpo como JSON sin procesar? Las solicitudes son JSON sin procesar en UTF-8, no campos de formulario.
- ¿La comprobación del AuthToken es correcta? Cada callback lleva un AuthToken. Compáralo con el token configurado en el API Monitor y rechaza si no coincide. Asegúrate de no rechazar solicitudes válidas por comparar con un token equivocado.
- ¿El cifrado está activado? Si hay una Security Key configurada en el API Monitor, las cargas van cifradas. Tu servidor debe descifrarlas con la misma clave. Si no pensabas usar cifrado, elimina la clave.
- ¿La entrega se pausó? Si tu servidor respondió algo inesperado, la entrega se intenta hasta tres veces y luego se pausa, con un nuevo intento cada tres horas. Corrige el servidor y reinicia la cola desde la página Device Status. Consulta Punches not transmitting or queuing up.
Pruébalo
- Envía un POST de prueba a tu URL con Postman o cURL.
- Para probar desde tu propio equipo, usa un túnel como ngrok. Consulta Testing callback URLs from your local environment.
- Para construir el receptor, consulta Building a biometric callback receiver.
Los eventos que no se pudieron entregar se guardan y se envían cuando tu servidor vuelve. Consulta Punches made while a device was offline.
¿Sigues atascado? Escribe a support@camsbiometrics.com con el número de serie del dispositivo y una breve descripción del problema.
Was this article helpful?