API로 ZKTeco 생체인식 단말기를 클라우드 앱과 연동하기
생체인식 출퇴근 시스템은 업무 효율화와 보안 강화를 원하는 현대 기업에 점점 더 필수적인 요소가 되고 있습니다. ZKTeco 생체인식 단말기와 클라우드 애플리케이션의 연동은 ZKTeco를 비롯한 다양한 장치를 지원하는 Cams Biometrics API를 사용하면 원활하게 구현할 수 있습니다.
Cams 생체인식 단말기
Cams 생체인식 단말기( http://camsbiometrics.com/product/home.html)를 보유하고 계시다면 당사 봇으로 장치를 검증하실 필요가 없습니다. 모든 Cams 생체인식 단말기는 Web API를 통해 작동할 수 있습니다. 당사 봇(https://developer.camsbiometrics.com)은 다른 브랜드의 API 지원 호환성을 확인하기 위해 만들어졌습니다. Cams 이외 브랜드의 생체인식 단말기를 사용하신다면 계속 진행해 주세요.
ZKTeco 하드웨어의 API 지원 여부 확인
연동을 시작하기 전에 ZKTeco 장치가 Web API 통신과 호환되는지 확인하세요. Developer BOT( https://developer.camsbiometrics.com )에서 장치를 검증하여 확인할 수 있습니다. 요청된 정보와 장치의 정확한 시리얼 번호를 입력한 뒤 “start verify” 버튼을 클릭하세요. 그러면 BOT이 TODO/ACTION-REQUIRED 지침을 안내합니다. 생체인식 단말기에 사용자를 추가하거나 출퇴근 기록(punch)을 남기는 등, 안내에 따라 단말기에서 주의 깊게 수행하세요. 장치에 이미 사용자가 등록되어 있더라도 BOT이 요청하면 새로운(더미) 사용자를 추가해야 합니다.
장치 검증이 완료되면 Cams 영업팀(+91-98409-41006, 전화/WhatsApp) 또는 sales@camsbiometrics.com 으로 연락하여 API 청구서(invoice) 발행을 요청하세요.
세금계산서가 발행되는 즉시 장치에 API 액세스가 제공됩니다.
지원 장치 실적
developer.camsbiometrics.com 플랫폼은 다양한 생체인식 모델별 성공률 실적을 관리하며, 클라우드 애플리케이션과 연동할 때 각 장치의 신뢰도를 보여줍니다. 다음은 API 통신 성공률이 가장 높은 ZKTeco 모델 상위 5개입니다.
- 참고로 https://camsbiometrics.com/product/home.html 에 나열된 모든 Cams 생체인식 단말기는 기본적으로 API를 지원합니다. 아래 내용은 ZKTeco 및 기타 브랜드 모델에만 해당됩니다.
- 기존(Traditional) 모델
- IN02-A: 성공률 97%
- UFace 800: 성공률 96%
- S922: 성공률 96%
- F19: 성공률 93%
- IFace 880: 성공률 92%
- 가시광선(Visible Light, VL) 모델
- V5Lx 시리즈 단말기의 94%가 지원됩니다
- V4Lx 시리즈 단말기의 88%가 지원됩니다
- 기타 브랜드
- eSSL 단말기 80% 이상
- BioMax 구형 모델 단말기 80% 이상
- Identix 단말기 80% 이상
- Mantra 단말기 20% 이상 (여러 차례 데이터 유실 문제가 발생하여 API 통신에는 권장하지 않습니다)
- RealTimeBiometrics – 지원을 시작하기 위해 해당 팀과 긴밀히 협력하고 있습니다.
미지원 장치
다음 브랜드는 출퇴근 기록 유실 및 복구 불가능한 데이터 손상 등 반복적인 장애로 인해 2023년에 지원이 중단되었습니다. 이러한 문제를 근본적으로 해결하기 위한 제조사의 지원을 받을 수 없었습니다. 따라서 해당 제조사 엔지니어링 팀의 충분한 지원을 받을 때까지 이 브랜드들은 지원하지 않습니다.
- HikVision
- Secureye
- Secugen
- Suprema
위에 언급된 브랜드는 전 세계 시장의 3% 미만을 차지합니다. 따라서 고객께서는 이를 제외하고 더 적합한 대안을 선택하셔도 됩니다. 다만 이 모델들도 근거리 통신망(LAN) 환경 및 데스크톱 애플리케이션에서는 여전히 잘 작동할 수 있습니다.
이러한 통계는 클라우드 애플리케이션과의 연동을 성공적으로 수행하기 위해 각 장치의 기능을 검증하는 것이 중요함을 보여줍니다.
펌웨어는 시간이 지나면서, 그리고 지역에 따라 다를 수 있습니다. 따라서 모델만으로는 장치가 API 연동을 지원하는지 확인할 수 없습니다. 일반적으로 ADMS, WDMS 또는 내장 클라우드 서버가 있는 단말기는 장치 호환성 검증에 사용할 수 있습니다.
검증 없이도 API 지원 여부를 확인할 수 있나요?
ZKTeco 단말기의 펌웨어는 국가별로, 그리고 같은 모델이라도 시기에 따라 다르기 때문에 API 지원 여부 검증은 필수입니다. 또한 ADMS 기능은 사용 빈도가 낮아 제조사의 테스트가 제한적입니다. 이로 인해 데이터 유실, 데이터 전송 손상, 트랜잭션 중 명령 무응답과 같은 문제가 발생할 수 있습니다. 따라서 ZKTeco 생체인식 출퇴근 또는 출입 통제 장치의 API 호환성을 확인하려면 이 검증 절차를 반드시 거쳐야 합니다.
이 검증 절차 없이 API 지원이 보장된 장치를 원하신다면 Cams Biometrics Machines
장치를 네트워크에 연결하기
ZKTeco 장치는 개발자 포털과 통신하기 위해 인터넷에 연결되어 있어야 합니다. https://forum.camsbiometrics.com/network-and-server-setup-guide-to-verify-compatibility-of-third-party-biometric-devices/ 에서 안내하는 설정이 생체인식 하드웨어에 적용되어 있는지 확인하세요.
또한 효과적인 검증을 위해 단말기가 온라인 상태여야 합니다. 장치를 온라인으로 연결하는 데 도움이 필요하시면 https://forum.camsbiometrics.com/how-to-bring-the-cams-biometrics-machine-online/ 문서를 참고하세요.
연동 API
API 문서를 처음부터 끝까지 꼼꼼히 읽고 원활한 연동을 위한 소프트웨어를 구현하세요. API를 구매하면 Cams 관리자 패널(cams admin panel)에서 장치의 콜백(call back) API URL을 설정할 수 있습니다.
API가 활성화되는 즉시 출퇴근 기록(punch log)이 실시간으로 서버에 전송됩니다.
API 문서는 다음 주소에서 확인할 수 있습니다: https://camsbiometrics.com/application/biometric-web-api.html.