
타사 애플리케이션이 스마트 락을 작동해야 할 때 — 임대 채널의 코드 발급, 사무실 플랫폼의 방문자 등록, 호텔 앱의 모바일 키 전달 — 락 공급업체는 두 개의 계층으로 구성되는 프로그래밍 가능한 인터페이스를 제공합니다. 클라우드 API는 일반적으로 HTTPS를 사용하는 REST 방식의 서비스입니다. 애플리케이션은 OAuth 방식의 자격 증명으로 인증하고, 암호 또는 전자 키를 생성하며, 온라인 락에 원격 잠금 해제 명령을 전송하고, 락 상태를 조회하며, 잠금 해제, 배터리 부족 및 변조 이벤트에 대한 webhook 콜백을 받습니다. 모바일 SDK는 통합업체 자체의 iOS 또는 Android 앱에 삽입되는 라이브러리로, 서버 왕복 없이 Bluetooth 검색, 보안 연결, 근거리 잠금 해제 및 오프라인 자격 증명 로직을 처리합니다. 성공적인 통합에서는 두 계층을 의도적으로 함께 사용하고, 자격 증명을 보안하며, 출시 전에 속도 제한과 이벤트 전달을 테스트합니다. 이 가이드는 중요한 개념과 공급업체에 확인할 사항을 정리합니다. 각 플랫폼의 API 및 SDK 지원 여부, 범위 및 라이선스는 견적마다 서면으로 확인됩니다.
| 클라우드 API | HTTPS 서비스가 서버를 통해 락, 자격 증명 및 이벤트를 관리합니다. Wi-Fi 또는 게이트웨이를 통해 락이 온라인 상태일 때만 원격 문에 접근할 수 있습니다. |
| 모바일 SDK | 삽입형 iOS/Android 라이브러리가 통합업체 자체 앱 안에서 Bluetooth 연결, 근거리 잠금 해제 및 오프라인 로직을 처리합니다. |
| 인증 | OAuth 방식의 클라이언트 자격 증명, 범위가 지정된 토큰 및 서명된 webhook이 전문 플랫폼과 공개 릴레이 스크립트를 구분합니다. |
| API별 자격 증명 | 일반적인 작업에는 유효기간이 지정된 암호, 전자 키, 카드 및 방문자 링크 생성 기능이 있으며, 조회, 업데이트 및 취소 엔드포인트도 제공합니다. |
| 이벤트 전달 | Webhook이 잠금 해제, 코드 사용, 배터리 부족 및 출입 이벤트에 대해 알립니다. 재시도 동작과 순서 보장 기준은 문서로 명확히 밝혀야 합니다. |
| 하드웨어 의존성 | 원격 명령은 Wi-Fi 또는 게이트웨기를 통해 온라인 상태인 락에서만 실행되므로 API 설계와 하드웨어 토폴로지를 함께 계획해야 합니다. |
| 당사 정책 | 인터페이스 문서, 샌드박스 또는 테스트 장치 및 기술 담당자를 제공합니다. 운영 자격 증명과 제한 사항은 플랫폼 계약에 따라 제공됩니다. |
서버 측 자동화(임대 채널, PMS, 방문자 관리)는 클라우드 API를 기반으로 하며, 근거리 또는 오프라인 제어를 branded 휴대폰 앱에는 모바일 SDK가 추가됩니다. 두 가지 모두 필요한 제품은 코드를 작성하기 전에 자격 증명 모델을 설계해야 합니다.
| 통합 목표 | 주요 도구 세트 | 핵심 의존성 |
|---|---|---|
| 유효기간이 지정된 임대 코드 발급 | 예약 백엔드의 클라우드 API | 락이 대상 코드 유형과 동기화 경로를 지원해야 합니다. |
| 브랜드임 테넌트 앱 | 모바일 SDK와 클라우드 API | 앱 팀에서 SDK 출시 및 스토어 심사를 관리합니다. |
| 호텔 모바일 키 전달 | PMS 미들웨어의 클라우드 API 이벤트 | 자격 증명 서비스와 문에 설치된 게이트웨이의 범위가 필요합니다. |
| 방문자 관리 키오스크 | 일회용 자격 증명용 클라우드 API | 시간대와 만료 의미를 조기에 검증해야 합니다. |
| 실시간 원격 컨시어지 | 클라우드 API 잠금 해제와 webhook 확인 | 온라인 상태인 락만 원격 명령을 즉시 실행합니다. |
| 오프라인 기업용 지갑 | 보안 로컬 자격 증명이 적용된 모바일 SDK | 장치의 키 저장 및 취소 규칙이 필요합니다. |
API는 개구부에서 물리적 현실과 만납니다. 게이트웨이, 금속문 및 배터리 작동 시간이 깔끔한 API 호출이 제때 락에 도달하는지 여부를 결정합니다. 파일럿 하드웨어와 소프트웨어를 함께 테스트해야 합니다.
| 개구부 | 일반적인 문 | 락 접근 방식 |
|---|---|---|
| 임대 유닛 문 | 구역별 게이트웨이가 연결된 Bluetooth 락 | 예약 백엔드가 클라우드 API를 통해 오프라인 및 온라인 코드를 생성합니다. |
| 사무실 유리 입구 | 온라인 리더 또는 컨트롤러 | 방문자 플랫폼이 일회용 자격 증명을 전송하고 출입 webhook을 받습니다. |
| 호텔 객실 | 모바일 키 서비스를 지원하는 RFID 락 | PMS 미들웨어가 키 API를 호출하고 게이트웨이가 실시간 업데이트를 전송합니다. |
| 코워킹 스페이스 문 | 유리 파사드 뒤에 설치된 스마트 락 | 회원 앱은 약한 Wi-Fi에서도 근거리 잠금 해제를 위해 SDK를 삽입합니다. |
| 물류 게이트 | 실외용 온라인 락 | 원격 명령에는 확인된 연결성과 대체 통신 수단이 필요합니다. |
| 편의시설 공간 | 원격 관리되는 배터리 락 | Webhook 기록을 통해 운영자 앱에서 이용료 청구 및 남용 여부를 검토합니다. |
API는 프레젠테이션에서는 비슷해 보이지만 운영 환경에서는 차이가 큽니다. 엔지니어링 시간을 투입하기 전에 통합업체는 아래 항목을 수집해야 합니다. 당사는 이 모든 항목에 대해 플랫폼 팀과 조율하는 것을 돕습니다.
| 구성 요소 | 일반적인 로직 | 참고 사항 |
|---|---|---|
| API 레퍼런스 | 엔드포인트, 범위, 버전 및 샌드박스 지원 여부. | 엔지니어링 산정에는 완전하고 최신 문서가 필요합니다. |
| SDK 패키지 | 지원 OS 버전, 샘플 앱 및 출시 주기. | 스토어 승인 및 유지보수 방식을 이해해야 합니다. |
| 보안 모델 | 토큰 유형, 비밀 키 교체, webhook 서명 및 IP 옵션. | 운영 환경에서 잠금 해제 엔드포인트 보호는 필수입니다. |
| 제한 및 할당량 | 속도 제한, 페이지네이션, 일괄 작업 및 재시도 규칙. | 그렇지 않으면 피크 체크인 시간대에 전체 장비 출시에 실패할 수 있습니다. |
| 이벤트 카탈로그 | 이벤트 유형, 페이로드, 순서 및 재전달 보장. | 감사 및 알림 기능은 안정적인 이벤트에 좌우됩니다. |
API는 서버 간 인터페이스입니다. 백엔드가 HTTPS를 통해 락 플랫폼을 호출하여 코드 생성, 온라인 락에 잠금 해제 명령 전송, 상태 조회 및 webhook 이벤트 수신을 수행하며, 휴대폰이 가까이 있어야 하는지와 관계없이 작동합니다. 모바일 SDK는 자체 iOS 또는 Android App에 내장되는 소프트웨어 라이브러리로, Bluetooth를 통해 락과 직접 통신하므로 가까운 거리에서 잠금 해제, 설정 및 서버에 연결할 수 없는 환경에서의 오프라인 자격 증명 저장 기능을 지원합니다. 임대용 백엔드와 PMS 통합은 주로 클라우드 API가 필요하며, 브랜딩된 임차인용 App은 일반적으로 SDK와 일부 API 호출이 모두 필요합니다. 모든 작업을 API로만 처리하려는 시도, 예를 들어 게이트웨이 없이 세계 반대편에서 Bluetooth 전용 락을 잠금 해제하려는 시도는 작동하지 않습니다. 따라서 하드웨어 토폴로지와 인터페이스 선택을 함께 설계해야 합니다. 플랫폼별로 제공되는 인터페이스는 견적서마다 서면으로 확인됩니다.
네, 이것은 표준적인 통합 방식입니다. 예약이 확정되면 백엔드 또는 중간웨어가 룸 또는 유닛, 입실 및 퇴실 정보를 포함하여 락 플랫폼 API를 호출하고, 자체 메시지 또는 이메일 템플릿을 통해 게스트에게 전달되는 비밀번호 또는 ekey를 받습니다. 이후 webhook이 사용 여부를 확인하고 조기 체크인 시도나 배터리 부족과 같은 이벤트를 표시합니다. 확정해야 할 사항에는 날짜 범위의 시간대 처리, 선택한 락에서 오프라인으로 작동하는 코드 유형, 실시간 폐기를 위한 게이트웨이 범위, 메시지 재전송 시 멱등성 재시도, 취소 및 날짜 변경 시 자격 증명 업데이트 방법이 포함됩니다. 테스트 락과 통합 워크숍을 지원하며, 플랫폼별 엔드포인트 세부 정보, 속도 제한 및 라이선스는 견적서마다 서면으로 확인됩니다.
플랫폼이 인증이 적용된 금융 API와 유사하게 구축된 경우 원격 잠금 해제는 안전합니다. 범위가 제한된 OAuth 방식 토큰, 서버 측 비밀 정보 저장, 직원별 권한, webhook을 통한 명령 확인, 감사 로그 및 민감한 문에 대한 선택적 2단계 승인이 사용됩니다. 통합 사업자가 장기간 유효한 비밀 정보를 휴대폰 App에 내장하거나 개방된 릴레이 엔드포인트를 노출하거나 잠금 해제 URL을 기록하면 위험해집니다. 물리적 안전장치도 중요합니다. 원격 명령은 온라인 락에만 전달되며, 고보안 문은 원격 잠금 해제를 완전히 비활성화하거나 이중 승인을 요구하는 경우가 많습니다. 실사 중에는 단순히 “REST API 제공”이라는 주장만 받아들이지 말고 보안 화이트페퍼, 토큰 교체 절차 및 webhook 서명 방식을 요청하십시오. 이러한 검토는 플랫폼 팀과 조정하며, 원격 잠금 해제를 접수 역할로 제한하는 아키텍처를 제안할 수 있습니다.
webhook은 잠금 해제 기록, 코드 입력, 배터리 부족, 변조 경보 및 문 센서 변경과 같은 이벤트를 전달하는 표준 채널이지만, 전달 방식은 플랫폼마다 다릅니다. 전문적인 플랫폼은 페이로드를 서명하고, 실패한 전달을 지수 백오프로 재시도하며, 누락된 이벤트를 조정하거나 조회할 API를 제공합니다. 네트워크가 일시적으로 실패하고 중복 전달이 일반적인 현상이므로 이러한 조정이 중요합니다. 따라서 소비자는 이벤트 ID를 멱등적으로 처리해야 합니다. 순서 보장은 상대적으로 약합니다. 몇 초 간격으로 생성된 두 이벤트가 가끔 역순으로 도착할 수 있으므로, 감사 로직은 도착 시간이 아니라 락 이벤트 시각을 기준으로 타임스탬프를 기록해야 합니다. 파일럿 단계에서 오프라인 수신기를 모방하고 재생 동작을 확인하십시오. 순서가 보장된 플랫폼의 이벤트 카탈로그, 재시도 정책 및 조정 엔드포인트는 개발 시작 전에 문서로 제공됩니다.
API 접근 권한은 락 플랫폼의 자체 개발자 및 상업 조건에 따라 계정 소유자에게 부여됩니다. 일반적으로 클라우드 프로젝트를 보유한 브랜드 또는 운영자이며, 모든 락 구매자에게 자동으로 부여되는 것은 아닙니다. 공장은 서비스 활성화, 문서 제공 및 기술 온보딩 조정을 도울 수 있지만, 플랫폼 계약 범위를 벗어난 권한을 부여할 수는 없습니다. 일부 플랫폼은 App 전용 사용자, 대시보드가 있는 비즈니스 계정, 전체 API 접근 권한을 가진 인증 개발자 파트너를 구분하며, 일부 고급 엔드포인트에는 승인된 통합 검토가 필요합니다. 따라서 깊은 통합을 계획하는 구매자는 하드웨어를 선택하기 전에 개발자 자격, 비용, 데이터 처리 조건 및 지원 지역을 확인해야 합니다. API 사용 권한이 없는 우수한 락으로는 계획한 제품 구동이 불가능하기 때문입니다. 현재 개발자 프로그램과 플랫폼별 라이선스는 RFQ마다 확인됩니다.
RFQ로 통합 활용 사례, 팀의 기술 스택 및 출시 일정을 공유하십시오. API 문서, SDK 패키지, 테스트 장치 및 플랫폼 계약을 조정하며, 오프라인, 재시도 및 대규모 장군 이벤트 범위를 다루는 공동 파일럿을 지원합니다.
명세서 및 견적 요청기술 개요마지막 업데이트: 2026년 10월 31일 · Smart Lock Factory 편집팀 검토