사례 연구: 한 대의 장치에서 여러 서버로 출결 데이터 전송하기
요구 사항
한 고객사는 생체인식 장치를 한 대만 보유하고 있었지만, 해당 장치의 출결 데이터를 두 개의 별도 소프트웨어 시스템으로 전달해야 했습니다. 예를 들어 사내 HR 플랫폼과 외부 급여 업체의 시스템에 각각 데이터를 보내야 했으며, 장치를 한 대 더 설치하거나 두 시스템 사이에서 하드웨어를 나누어 쓰지 않아도 되는 방법이 필요했습니다.
듀얼 API 개념이 적합한 이유
일반적으로 장치 한 대는 API 하나와 콜백 URL 하나에 연결되며, 모든 출결 기록은 단일 대상으로만 전송됩니다. 듀얼 API 개념은 이러한 일대일 제한을 없앱니다. 고객사는 장치를 추가로 구매하는 대신, 동일한 물리적 장치에 대해 API 라이선스를 하나 더 구매합니다. 각 API에는 고유한 콜백 URL이 할당되며, 장치는 모든 출결 기록을 설정된 모든 URL로 동시에 전송합니다. 순차적으로 보내거나 지연 없이 보내는 방식이 아닙니다.
즉, 고객사는 출입구에 장치를 두 대 설치하거나, 등록 절차를 두 번 거치거나, 하드웨어 유지보수를 두 세트로 관리할 필요가 없습니다. 하나의 출결 기록, 하나의 장치, 여러 대상입니다.
작동 흐름
듀얼 API 흐름: 하나의 출결 기록을 설정된 두 개의 콜백 URL로 동시에 전송
- 사용자는 평소와 같이 장치에 출결을 기록합니다. 최종 사용자의 사용 방식에는 변화가 없습니다.
- 장치에는 각각 고유한 콜백 URL을 가리키는 API가 두 개(또는 그 이상) 설정됩니다.
- 출결 기록은 설정된 모든 URL로 동시에 전송됩니다.
- 각 수신 서버 또는 소프트웨어는 기록을 독립적으로 처리하며, 한 시스템은 다른 시스템의 응답에 의존하지 않습니다.
두 개 이상으로 확장하기
이 방식은 대상을 두 곳으로만 제한하지 않습니다. 같은 개념을 단일 장치의 n개 API로 확장할 수 있으며, 추가되는 각 API는 고유한 콜백 URL을 가진 또 하나의 섀도우(shadow) API가 되고, 장치는 이들 모두에 동시에 전송합니다. 예를 들어 HR, 급여, 컴플라이언스 대시보드에 출결 데이터를 동기화하는 고객사라면, 리더기를 세 대 운영하는 대신 장치 한 대에 API를 세 개 설정할 수 있습니다.
구매 시 필요한 항목
|
장치의 첫 번째 API
|
추가 섀도우(shadow) API 각각
기존 장치를 그대로 재사용하므로 장치 비용은 적용되지 않습니다. |
구현 참고 사항
- 각 API와 콜백 URL 쌍은 독립적으로 작동합니다. 한 콜백 URL에서 오류가 발생하거나 응답이 느려도 다른 URL로의 전송이 차단되거나 지연되지 않습니다.
- 전송이 한 서버에서 다음 서버로 중계되는 방식이 아니라 동시에 이루어지므로, 수신 시스템 간에 관리해야 할 의존 관계 체인이 없습니다.
- 두 시스템이 서로 통신할 필요 없이 동일한 원본 출결 데이터를 서로 다른 목적(예: 급여 처리 대 출입 기록)으로 사용해야 할 때 특히 효과적입니다.
- 각 API와 해당 콜백 URL은 대시보드에서 독립적으로 설정됩니다. 섀도우 API를 추가해도 장치 자체의 재설정은 필요하지 않습니다.
- 각 섀도우 API로의 전송 상태는 API Monitor에서 개별적으로 확인하십시오. 한 콜백 URL의 전송 문제가 다른 URL에서 반드시 나타나는 것은 아니기 때문입니다.
- 대상들이 완전히 분리되어 있으므로, 듀얼 API는 시스템 이전을 병행 진행하는 데에도 적합합니다. 새 시스템을 검증하는 동안 기존 시스템이 계속 데이터를 수신하도록 유지하고, 전환에 충분한 확신이 생기면 이전 콜백 URL을 폐기하면 됩니다.
결과
고객사는 기존의 단일 장치를 그대로 활용하여 두 대상으로 데이터를 전송해야 하는 요구 사항을 충족했습니다. 두 번째 장치를 도입하는 데 따르는 비용과 복잡성을 피할 수 있었습니다. 설정 과정에서는 두 번째 대상을 위한 추가 API 라이선스만 구매했으며, 장치 비용은 한 번만 발생했습니다.