Translated from the English article and reviewed by a person. Read the English original
Fix
Callback URL이 데이터를 받지 못할 때: 점검 목록
punch가 callback URL에 도착하지 않으면 다음 항목을 순서대로 점검하세요.
- 기기가 Cams에 연결되어 있나요? Device Status 페이지를 여세요. 기기가 오프라인이면 Why a device shows offline(기기가 오프라인으로 표시되는 이유)을 참고하세요.
- URL이 올바른가요? API Monitor 계정에 저장된 callback URL을 확인하세요.
- 서버가 올바르게 응답하나요? 자체 처리가 실패하더라도 항상
{"status":"done"}과 HTTP 상태 200으로 응답하세요. Cams가 기다리지 않도록 무거운 작업은 나중에 큐에서 처리하세요. - 엔드포인트가 인터넷에서 접근 가능한가요? 운영 환경에서는 포트 80(HTTP) 또는 443(HTTPS)을 사용하세요. 포트 8123은 테스트 전용입니다. 방화벽에서 이 포트들을 허용하세요.
- HTTPS가 올바르게 설정되어 있나요? 포트 443의 유효한 SSL 인증서를 사용하는 HTTPS를 지원하며 권장합니다. 서버를 재시작하지 않고도 인증서가 갱신되는지 확인하세요.
- 본문을 raw JSON으로 읽고 있나요? 요청은 폼 필드가 아니라 UTF-8 raw JSON입니다.
- AuthToken 확인이 올바른가요? 각 callback에는 AuthToken이 포함됩니다. API Monitor에 설정된 토큰과 비교하고 일치하지 않으면 거부하세요. 잘못된 토큰과 비교하여 정상 요청을 거부하고 있지 않은지 확인하세요.
- 암호화가 켜져 있나요? API Monitor에 Security Key가 설정되어 있으면 페이로드가 암호화됩니다. 서버가 같은 키로 복호화해야 합니다. 암호화를 사용할 의도가 없었다면 키를 제거하세요.
- 전달이 일시 중지되었나요? 서버가 예상과 다른 응답을 보내면 전달을 최대 세 번 시도한 후 일시 중지되며, 3시간마다 다시 시도합니다. 서버를 수정하고 Device Status 페이지에서 큐를 다시 시작하세요. Punches not transmitting or queuing up(출퇴근 기록이 전송되지 않거나 대기열에 쌓일 때)을 참고하세요.
테스트하기
- Postman이나 cURL로 URL에 테스트 POST를 보내세요.
- 자신의 컴퓨터에서 테스트하려면 ngrok 같은 터널을 사용하세요. Testing callback URLs from your local environment(로컬 환경에서 callback URL 테스트)를 참고하세요.
- 수신기를 구축하려면 Building a biometric callback receiver(생체인식 callback 수신기 구축)를 참고하세요.
전달하지 못한 이벤트는 보관되었다가 서버가 복구되면 전송됩니다. Punches made while a device was offline(오프라인 중 기록된 출퇴근 기록)를 참고하세요.
해결되지 않으면 기기 시리얼 번호와 문제에 대한 간단한 설명을 함께 support@camsbiometrics.com으로 이메일을 보내 주세요.
Was this article helpful?