Dynamic QR 코드 연동하기
CLUe Dynamic QR 코드는 생성부터 검증까지 전 과정을 지원하는 통합 QR 솔루션입니다. 이 문서는 CLUe Dynamic QR 코드를 자체 시스템에 연동하려는 개발자를 대상으로, API 키 발급부터 서비스 설정까지의 절차를 안내합니다.
CLUe Dynamic QR 코드란
CLUe Dynamic QR 코드는 생성부터 검증까지 전 과정을 지원하는 통합 솔루션으로, 고객사가 QR 코드 기능을 처음부터 직접 개발하지 않고도 자체 시스템에 손쉽게 연동할 수 있도록 설계되었습니다.
CLUe Dynamic QR 코드는 고객사 확인(Vendor) 서비스 방식과 함께 사용할 수 있습니다. 고객사 확인 설정에 대한 자세한 내용은 서비스 설정하기를 참고하세요.
시작하기 전에
CLUe Dynamic QR 코드는 연동을 목적으로 하므로, 공간 그룹(Place Group) API 키가 필요하며 테스트를 위한 벤더 코드도 적용해야 합니다.
API 키 발급
-
CLUe 웹 포털에 로그인하세요.
-
API 연동을 위한 공간 그룹을 선택하세요.
-
화면 오른쪽 상단의 → 상세 설정을 클릭하세요.
-
화면 왼쪽 사이드바에서 관리자를 클릭하세요.
-
API Key 관리 섹션에서 + 신규 발급을 클릭하세요.
-
원하는 유효 기간을 선택하세요.
직접 입력을 선택하면 유효 기간을 최대 365,000일까지 설정할 수 있습니다.
-
새 API 키를 발급하려면 생성 버튼을 클릭하세요.
-
새 API 키가 생성되면 복사 버튼을 클릭해 CLUe API 호출 시 Bearer 토큰으로 사용하세요.
API 키는 CLUe API에 대한 접근 권한을 그대로 부여하므로 외부에 노출되지 않도록 안전하게 보관하세요. 오남용으로 발생하는 문제에 대해 슈프리마는 책임지지 않습니다.
서비스 설정
공간 그룹의 서비스 설정에서 출입 방식을 고객사 확인으로 설정하고, CLUe QR을 선택하세요.
고객사 확인 코드는 QR 연동 절차에 따라 슈프리마 CLUe 팀으로부터 발급받아 설정해야 합니다.
고객사 확인 코드 없이 테스트할 수 있나요?
가능합니다. 다만 이때는 시스템에 테스트용 고객사 확인 코드를 설정해야 합니다. 슈프리마 담당자에게 문의해 지원을 요청하세요. 테스트용 고객사 확인 코드는 접근 권한이나 유효 기간을 검증하지 않고 접근을 허용합니다.