Translated from the English article and reviewed by a person. Read the English original
Fix
Callback URL che non riceve dati: una checklist
Se le punch non arrivano al tuo callback URL, esegui questi controlli in ordine.
- Il dispositivo raggiunge Cams? Apri la pagina Device Status. Se il dispositivo è offline, vedi Perché un dispositivo risulta offline.
- L'URL è corretto? Controlla il callback URL salvato nel tuo account API Monitor.
- Il tuo server risponde correttamente? Rispondi sempre con
{"status":"done"}e stato HTTP 200, anche se la tua elaborazione fallisce. Svolgi il lavoro pesante dopo, in una coda, così Cams non resta mai in attesa. - L'endpoint è raggiungibile da internet? In produzione usa la porta 80 (HTTP) o 443 (HTTPS). La porta 8123 è solo per i test. Consenti queste porte nel firewall.
- HTTPS è configurato correttamente? HTTPS con un certificato SSL valido sulla porta 443 è supportato e consigliato. Assicurati che il certificato si rinnovi senza riavviare il server.
- Leggi il corpo come JSON grezzo? Le richieste sono JSON grezzo in UTF-8, non campi di un modulo.
- Il controllo dell'AuthToken è corretto? Ogni callback contiene un AuthToken. Confrontalo con il token impostato nell'API Monitor e rifiuta se non corrisponde. Assicurati di non rifiutare richieste valide confrontandole con il token sbagliato.
- La cifratura è attiva? Se nell'API Monitor è impostata una Security Key, i payload sono cifrati. Il tuo server deve decifrarli con la stessa chiave. Se non volevi usare la cifratura, rimuovi la chiave.
- La consegna è in pausa? Se il tuo server ha risposto in modo inatteso, la consegna viene tentata fino a tre volte e poi messa in pausa, con un nuovo tentativo ogni tre ore. Risolvi il problema del server e riavvia la coda dalla pagina Device Status. Vedi Punch non trasmesse o in coda.
Provalo
- Invia un POST di prova al tuo URL con Postman o cURL.
- Per provare dal tuo computer, usa un tunnel come ngrok. Vedi Testare i callback URL dal tuo ambiente locale.
- Per creare il ricevitore, vedi Creare un ricevitore di callback biometrici.
Gli eventi che non è stato possibile consegnare vengono conservati e inviati quando il tuo server torna disponibile. Vedi Punch effettuate con il dispositivo offline.
Ancora bloccato? Scrivi a support@camsbiometrics.com indicando il numero di serie del dispositivo e una breve descrizione del problema.
Was this article helpful?