
Việc tích hợp ổ khóa vào ứng dụng, PMS hoặc nền tảng tòa nhà được thực hiện thông qua hai bộ công cụ khác nhau: cloud API cho thao tác từ xa và Bluetooth SDK để điều khiển bằng điện thoại trong phạm vi gần. Nhầm lẫn giữa hai loại này là lỗi lập kế hoạch tích hợp phổ biến nhất.
Khi một ứng dụng của bên thứ ba cần vận hành ổ khóa thông minh — một kênh cho thuê phát hành mã, một nền tảng văn phòng cấp quyền cho khách hoặc một ứng dụng khách sạn cung cấp khóa di động — nhà cung cấp ổ khóa cung cấp các giao diện có thể lập trình ở hai lớp. Cloud API thường là dịch vụ theo phong cách REST qua HTTPS: ứng dụng xác thực bằng thông tin đăng nhập theo phong cách OAuth, tạo mã truy cập hoặc ekey, gửi lệnh mở khóa từ xa cho ổ khóa trực tuyến, truy vấn trạng thái ổ khóa và nhận các lệnh gọi lại webhook cho sự kiện mở khóa, pin yếu và can thiệp. Mobile SDK là thư viện được tích hợp vào ứng dụng iOS hoặc Android của chính đơn vị tích hợp, xử lý việc khám phá Bluetooth, kết nối bảo mật, mở khóa trong phạm vi gần và logic thông tin đăng nhập ngoại tuyến mà không cần giao tiếp với máy chủ. Các tích hợp thành công sử dụng có chủ đích cả hai lớp, bảo mật thông tin đăng nhập và kiểm tra giới hạn tần suất cùng khả năng gửi sự kiện trước khi ra mắt. Hướng dẫn này ánh xạ các khái niệm và những câu hỏi cần làm rõ với nhà cung cấp. Khả năng cung cấp API và SDK, phạm vi sử dụng và cấp phép cho từng nền tảng được xác nhận bằng văn bản theo từng báo giá.
| Cloud API | Các dịch vụ HTTPS quản lý ổ khóa, thông tin đăng nhập và sự kiện từ máy chủ; chỉ truy cập được cửa từ xa khi ổ khóa trực tuyến qua Wi-Fi hoặc gateway. |
| Mobile SDK | Các thư viện iOS/Android được tích hợp xử lý kết nối Bluetooth, mở khóa trong phạm vi gần và logic ngoại tuyến bên trong ứng dụng của chính đơn vị tích hợp. |
| Xác thực | Thông tin đăng nhập máy khách theo phong cách OAuth, token có phạm vi và webhook có chữ ký giúp phân biệt nền tảng chuyên nghiệp với tập lệnh relay mở. |
| Thông tin đăng nhập theo API | Các thao tác phổ biến bao gồm tạo mã truy cập có thời hạn, ekey, thẻ và liên kết khách, cùng các endpoint để liệt kê, cập nhật và thu hồi. |
| Phân phối sự kiện | Webhook thông báo các sự kiện mở khóa, sử dụng mã, pin yếu và cửa; cơ chế thử lại và bảo đảm thứ tự sự kiện phải được ghi chép rõ ràng. |
| Phụ thuộc phần cứng | Lệnh từ xa chỉ thực hiện được trên ổ khóa trực tuyến qua Wi-Fi hoặc gateway, vì vậy thiết kế API và sơ đồ phần cứng phải được lập kế hoạch cùng nhau. |
| Chính sách của chúng tôi | Chúng tôi cung cấp tài liệu giao diện, môi trường thử nghiệm hoặc thiết bị thử nghiệm và đầu mối kỹ thuật; thông tin đăng nhập và giới hạn môi trường thực tế đến từ thỏa thuận nền tảng. |
Tự động hóa phía máy chủ (kênh cho thuê, PMS, quản lý khách) dựa trên cloud API; các ứng dụng điện thoại có thương hiệu với khả năng điều khiển trong phạm vi gần hoặc ngoại tuyến cần bổ sung Mobile SDK. Sản phẩm cần cả hai phương án nên thiết kế mô hình thông tin đăng nhập trước khi viết mã.
| Mục tiêu tích hợp | Bộ công cụ chính | Phụ thuộc quan trọng |
|---|---|---|
| Phát hành mã cho thuê có thời hạn | Cloud API từ hệ thống backend đặt phòng | Ổ khóa hỗ trợ loại mã mục tiêu và phương thức đồng bộ. |
| Ứng dụng dành cho người thuê có thương hiệu | Mobile SDK cùng cloud API | Nhóm phát triển ứng dụng chịu trách nhiệm phát hành SDK và đánh giá trên cửa hàng. |
| Cung cấp khóa di động cho khách sạn | Sự kiện cloud API từ phần mềm trung gian PMS | Dịch vụ thông tin đăng nhập và phạm vi phủ sóng gateway tại các cửa. |
| Kiosk quản lý khách | Cloud API cho thông tin đăng nhập dùng một lần | Múi giờ và ngữ nghĩa thời hạn được xác thực sớm. |
| Tiếp tân từ xa trực tiếp | Mở khóa qua cloud API kèm xác nhận webhook | Chỉ ổ khóa trực tuyến mới thực thi lệnh từ xa ngay lập tức. |
| Ví doanh nghiệp ngoại tuyến | Mobile SDK với thông tin đăng nhập cục bộ được bảo mật | Quy tắc lưu trữ khóa và thu hồi trên thiết bị. |
API gặp thực tế vật lý ngay tại lối vào: gateway, cửa kim loại và thời lượng pin quyết định một lệnh API gọn gàng có kịp đến ổ khóa hay không. Hãy thử nghiệm phần cứng và phần mềm cùng nhau.
| Lối vào | Cửa điển hình | Phương án ổ khóa |
|---|---|---|
| Cửa căn hộ cho thuê | Ổ khóa Bluetooth với gateway cho từng khu vực | Hệ thống backend đặt phòng tạo mã ngoại tuyến và trực tuyến thông qua cloud API. |
| Lối vào văn phòng kính | Đầu đọc hoặc bộ điều khiển trực tuyến | Nền tảng khách gửi thông tin đăng nhập dùng một lần và nhận webhook về lượt ra vào. |
| Phòng khách sạn | Ổ khóa RFID có dịch vụ khóa di động | Phần mềm trung gian PMS gọi API khóa; gateway đẩy các cập nhật trực tiếp. |
| Cửa không gian làm việc chung | Ổ khóa thông minh sau mặt kính | Ứng dụng thành viên tích hợp SDK để mở khóa trong phạm vi gần ngay cả khi Wi-Fi yếu. |
| Cổng logistics | Ổ khóa ngoài trời trực tuyến | Lệnh từ xa yêu cầu kết nối đã được xác nhận và liên hệ dự phòng. |
| Phòng tiện ích | Ổ khóa dùng pin được quản lý từ xa | Webhook hỗ trợ kiểm toán lượt sử dụng để tính phí và rà soát lạm dụng trong ứng dụng của đơn vị vận hành. |
API trên slide trông tương tự nhau nhưng lại khác nhau khi vận hành thực tế. Trước khi cam kết thời gian kỹ thuật, các đơn vị tích hợp nên thu thập các nội dung dưới đây, và chúng tôi hỗ trợ phối hợp tất cả nội dung này với nhóm nền tảng.
| Thành phần | Logic điển hình | Ghi chú |
|---|---|---|
| Tài liệu tham chiếu API | Endpoint, phạm vi, phiên bản và khả năng sử dụng môi trường thử nghiệm. | Ước tính kỹ thuật phụ thuộc vào tài liệu đầy đủ và cập nhật. |
| Gói SDK | Phiên bản OS được hỗ trợ, ứng dụng mẫu và tần suất phát hành. | Cần hiểu rõ quy trình phê duyệt trên cửa hàng và mô hình bảo trì. |
| Mô hình bảo mật | Loại token, luân chuyển bí mật, ký webhook và tùy chọn IP. | Bảo vệ endpoint mở khóa là yêu cầu không thể thỏa hiệp trong môi trường thực tế. |
| Giới hạn và hạn ngạch | Giới hạn tần suất, phân trang, thao tác hàng loạt và quy tắc thử lại. | Nếu không, việc triển khai cho đội xe có thể thất bại vào giờ nhận phòng cao điểm. |
| Danh mục sự kiện | Loại sự kiện, payload, thứ tự và bảo đảm gửi lại. | Tính năng kiểm toán và thông báo phụ thuộc vào sự kiện đáng tin cậy. |
API là giao diện từ máy chủ đến máy chủ: backend của bạn gọi nền tảng ổ khóa qua HTTPS để tạo mã, gửi lệnh mở khóa đến các ổ khóa trực tuyến, truy vấn trạng thái và nhận các sự kiện webhook; API hoạt động bất kể điện thoại có ở gần hay không. SDK di động là thư viện phần mềm được tích hợp vào ứng dụng iOS hoặc Android của chính bạn, giao tiếp trực tiếp với ổ khóa qua Bluetooth, cho phép mở khóa ở gần, thiết lập và lưu trữ thông tin xác thực ngoại tuyến khi không thể kết nối đến máy chủ. Backend cho thuê và tích hợp PMS chủ yếu cần API đám mây; ứng dụng dành cho khách thuê có thương hiệu thường cần SDK cùng một số lệnh API cụ thể. Cố gắng thực hiện mọi thao tác qua API — ví dụ mở khóa chỉ dùng Bluetooth từ bất kỳ đâu trên thế giới khi không có gateway — sẽ không thể hoạt động, vì vậy cấu trúc phần cứng và lựa chọn giao diện phải được thiết kế đồng bộ. Các giao diện có sẵn cho từng nền tảng được xác nhận bằng văn bản theo báo giá.
Có, đây là một mô hình tích hợp tiêu chuẩn: khi lượt đặt phòng được xác nhận, backend hoặc middleware của bạn gọi API của nền tảng ổ khóa với thông tin phòng hoặc căn hộ, ngày nhận phòng và trả phòng, sau đó nhận mật khẩu hoặc ekey được chuyển đến khách lưu trú qua mẫu tin nhắn hoặc email của chính bạn. Webhook sau đó xác nhận mức sử dụng và gắn cờ cho các sự kiện như cố nhận phòng sớm hoặc pin sắp hết. Các yêu cầu cần xác định gồm xử lý múi giờ cho khung ngày, loại mã có thể dùng ngoại tuyến trên các ổ khóa đã chọn, phạm vi phủ của gateway để thu hồi trực tiếp, cơ chế thử lại idempotent khi gửi lại tin nhắn và cách hủy đặt phòng hoặc thay đổi ngày cập nhật thông tin xác thực. Chúng tôi cung cấp ổ khóa thử nghiệm và hỗ trợ các buổi workshop tích hợp; chi tiết endpoint, giới hạn tốc độ và giấy phép cho từng nền tảng được xác nhận bằng văn bản theo báo giá.
Việc mở khóa từ xa an toàn khi nền tảng được xây dựng giống mọi API tài chính có xác thực: token theo phong cách OAuth với phạm vi giới hạn, lưu trữ bí mật phía máy chủ, quyền theo từng nhân viên, xác nhận lệnh qua webhook, nhật ký kiểm toán và tùy chọn phê duyệt hai yếu tố cho các cửa nhạy cảm. Tình huống trở nên nguy hiểm khi đối tác tích hợp nhúng bí mật có thời hạn dài vào ứng dụng điện thoại, để lộ endpoint relay mở hoặc ghi lại URL mở khóa. Các biện pháp bảo vệ vật lý cũng rất quan trọng: lệnh từ xa chỉ có thể đến các ổ khóa trực tuyến, và nhiều cửa bảo mật cao hoàn toàn vô hiệu hóa tính năng mở khóa từ xa hoặc yêu cầu phê duyệt kép. Trong quá trình thẩm định, hãy yêu cầu whitepaper bảo mật, quy trình luân chuyển token và phương thức ký webhook thay vì chỉ chấp nhận tuyên bố “REST API available”. Chúng tôi phối hợp các đợt rà soát này với nhóm nền tảng và có thể đề xuất kiến trúc giới hạn tính năng mở khóa từ xa cho các vai trò lễ tân.
Webhook là kênh sự kiện tiêu chuẩn — lịch sử mở khóa, nhập mã, pin thấp, cảnh báo can thiệp và thay đổi cảm biến cửa — nhưng cách giao sự kiện khác nhau tùy nền tảng. Các nền tảng chuyên nghiệp ký payload, thử lại giao hàng thất bại theo lịch backoff và cung cấp API để đối soát hoặc thăm dò các sự kiện bị bỏ sót. Điều này quan trọng vì mạng có thể gián đoạn trong thời gian ngắn và giao trùng lặp là điều bình thường; do đó, bên tiêu thụ phải xử lý ID sự kiện theo cách idempotent. Cam kết về thứ tự yếu hơn: hai sự kiện được tạo cách nhau vài giây đôi khi có thể đến ngược thứ tự, vì vậy logic kiểm toán nên lấy dấu thời gian từ thời điểm sự kiện trên ổ khóa thay vì thời điểm đến. Trong giai đoạn thử nghiệm, hãy mô phỏng bộ nhận ngoại tuyến và xác minh hành vi phát lại. Danh mục sự kiện, chính sách thử lại và endpoint đối soát cho nền tảng đã chọn được ghi nhận bằng văn bản trước khi phát triển bắt đầu.
Quyền truy cập API do nền tảng ổ khóa cấp theo điều khoản nhà phát triển và thương mại riêng, thường là chủ sở hữu tài khoản: thương hiệu hoặc đơn vị vận hành sở hữu dự án đám mây, không tự động áp dụng cho mọi người mua ổ khóa. Nhà máy có thể hỗ trợ kích hoạt dịch vụ, cung cấp tài liệu và phối hợp quá trình tiếp nhận kỹ thuật, nhưng không thể gán quyền vượt quá thỏa thuận với nền tảng. Một số nền tảng phân biệt người dùng chỉ dùng ứng dụng, tài khoản doanh nghiệp có dashboard và đối tác nhà phát triển được chứng nhận có quyền truy cập API đầy đủ; một số endpoint nâng cao yêu cầu đợt rà soát tích hợp được phê duyệt. Vì vậy, người mua có kế hoạch tích hợp sâu nên xác nhận điều kiện đủ điều kiện làm nhà phát triển, phí, điều khoản xử lý dữ liệu và khu vực được hỗ trợ trước khi chọn phần cứng, bởi một ổ khóa xuất sắc nhưng không có quyền API không thể vận hành sản phẩm dự kiến. Các chương trình nhà phát triển hiện hành và giấy phép theo từng nền tảng được xác nhận theo RFQ.
Chia sẻ các trường hợp sử dụng tích hợp, stack của đội ngũ và thời gian ra mắt cùng RFQ của bạn. Chúng tôi phối hợp tài liệu API, gói SDK, thiết bị thử nghiệm và thỏa thuận nền tảng, đồng thời hỗ trợ một đợt thử nghiệm phối hợp bao gồm ngoại tuyến, thử lại và sự kiện ở quy mô đội thiết bị.
Yêu cầu bảng thông số kỹ thuật và báo giáTổng quan công nghệCập nhật lần cuối: Ngày 31 tháng 10 năm 2026 · Được nhóm biên tập Smart Lock Factory đánh giá