Cảnh phát triển phần mềm trừu tượng với ổ khóa thông minh, máy tính xách tay và các nút giao diện đang lơ lửng, được kết nối bằng những vệt ánh sáng xanh mỏng trên bàn làm việc tối, ánh sáng kỹ thuật lạnh, không có người, không có văn bản đọc được, không có biểu trưng
Công nghệ

APIs và SDK cho ổ khóa thông minh: cách phần mềm thực sự mở cửa

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á.

Thông tin chính

APIs và SDK tổng quan

Cloud APICá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 SDKCá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ựcThô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 APICá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ệnWebhook 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ứngLệ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ôiChú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.
Đơn vị trả lời

Dự án tích hợp cần lựa chọn phương án nào?

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ợpBộ công cụ chínhPhụ thuộc quan trọng
Phát hành mã cho thuê có thời hạnCloud 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ệuMobile SDK cùng cloud APINhó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ạnSự kiện cloud API từ phần mềm trung gian PMSDị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áchCloud API cho thông tin đăng nhập dùng một lầnMú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ếpMở khóa qua cloud API kèm xác nhận webhookChỉ ổ 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ếnMobile SDK với thông tin đăng nhập cục bộ được bảo mậtQuy tắc lưu trữ khóa và thu hồi trên thiết bị.
Phạm vi áp dụng

Dự án, sản phẩm và bằng chứng

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àoCửa điển hìnhPhương án ổ khóa
Cửa căn hộ cho thuêỔ khóa Bluetooth với gateway cho từng khu vựcHệ 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ếnNề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 độngPhầ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ếnLệ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ừ xaWebhook 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.
Bộ tài liệu

Bộ tài liệu thẩm định tích hợp

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ầnLogic điển hìnhGhi chú
Tài liệu tham chiếu APIEndpoint, 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 SDKPhiê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ậtLoạ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ạchGiớ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ệnLoạ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.
Quy trình tích hợp

Vận hành dự án tích hợp qua năm bước

  1. Xác định mô hình thông tin đăng nhậpXác định ai nhận mã, ekey hoặc thẻ và cách các thông tin này hết hạn.
  2. Thu thập tài liệu và môi trường thử nghiệmRà soát tài liệu tham chiếu API, phạm vi và ứng dụng mẫu SDK ngay từ đầu.
  3. Xây dựng với thiết bị thử nghiệmPhát triển dựa trên các mẫu ổ khóa cụ thể, không dựa trên các tuyên bố tiếp thị chung chung.
  4. Kiểm tra các tình huống lỗiMô phỏng ổ khóa ngoại tuyến, webhook trùng lặp, token hết hạn và giới hạn tần suất.
  5. Thử nghiệm rồi mở rộngTriển khai thử trên một tòa nhà hoặc một tầng khách sạn trước khi phát hành trên toàn hệ thống.
FAQ

Các câu hỏi về API và SDK của ổ khóa thông minh

Sự khác biệt giữa API và SDK của ổ khóa thông minh là gì?

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á.

Nền tảng đặt phòng của chúng tôi có thể tự động gửi mã cho mỗi lượt đặt phòng không?

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á.

Cho phép ứng dụng mở cửa từ xa qua API có an toàn không?

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 có đảm bảo chúng tôi nhận được mọi sự kiện cửa không?

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.

Ai có thể sử dụng API: thương hiệu, nhà máy hay khách hàng cuối?

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.

Đang xây dựng phần mềm cho phần cứng ổ khóa thông minh?

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á

Giỏ hàng của bạn
Trải nghiệm của bạn trên trang web này sẽ được cải thiện bằng cách cho phép cookie Chính sách cookie
Chat on WhatsApp