Translated from the English article and reviewed by a person. Read the English original
Fix
Callback URL não recebe dados: um checklist
Se os punches não chegam à sua callback URL, faça estas verificações em ordem.
- O dispositivo alcança o Cams? Abra a página Device Status. Se o dispositivo estiver offline, veja Por que um dispositivo aparece offline.
- A URL está certa? Verifique a callback URL salva na sua conta do API Monitor.
- O seu servidor responde corretamente? Responda sempre com
{"status":"done"}e status HTTP 200, mesmo que o seu próprio processamento falhe. Faça o trabalho pesado depois, em uma fila, para que o Cams nunca fique esperando. - O endpoint é acessível pela internet? Use a porta 80 (HTTP) ou 443 (HTTPS) em produção. A porta 8123 é apenas para testes. Libere essas portas no seu firewall.
- O HTTPS está configurado corretamente? HTTPS com um certificado SSL válido na porta 443 é suportado e recomendado. Garanta que o certificado seja renovado sem reiniciar o servidor.
- Você lê o corpo como JSON bruto? As requisições são JSON bruto em UTF-8, não campos de formulário.
- A verificação do AuthToken está correta? Cada callback traz um AuthToken. Compare-o com o token definido no API Monitor e rejeite se não corresponder. Garanta que você não está rejeitando requisições válidas por comparar com o token errado.
- A criptografia está ativada? Se uma Security Key estiver definida no API Monitor, os payloads são criptografados. O seu servidor deve descriptografá-los com a mesma chave. Se você não pretendia usar criptografia, remova a chave.
- A entrega foi pausada? Se o seu servidor respondeu algo inesperado, a entrega é tentada até três vezes e depois pausada, com uma nova tentativa a cada três horas. Corrija o servidor e reinicie a fila pela página Device Status. Veja Punches não transmitidos ou acumulados na fila.
Teste
- Envie um POST de teste para a sua URL com Postman ou cURL.
- Para testar a partir do seu próprio computador, use um túnel como o ngrok. Veja Testando callback URLs no seu ambiente local.
- Para criar o receptor, veja Criando um receptor de callback biométrico.
Os eventos que não puderam ser entregues são guardados e enviados assim que o seu servidor voltar. Veja Punches feitos com o dispositivo offline.
Ainda com problemas? Envie um e-mail para support@camsbiometrics.com com o número de série do dispositivo e uma breve descrição do problema.
Was this article helpful?