
การเชื่อมต่อล็อกเข้ากับแอป, PMS หรือแพลตฟอร์มอาคาร ทำผ่านชุดเครื่องมือสองประเภทที่แตกต่างกัน ได้แก่ cloud API สำหรับการควบคุมระยะไกล และ Bluetooth SDK สำหรับการควบคุมจากโทรศัพท์ในระยะใกล้ การสับสนระหว่างสองส่วนนี้เป็นข้อผิดพลาดในการวางแผนผสานระบบที่พบบ่อยที่สุด
เมื่อแอปของบุคคลที่สามต้องใช้งานสมาร์ตล็อก เช่น ช่องทางปล่อยเช่าที่ออกรหัส ระบบสำนักงานที่จัดส่งสิทธิ์เข้าใช้พื้นที่สำหรับผู้เยี่ยมชม หรือแอปโรงแรมที่ส่งคีย์ผ่านมือถือ ผู้ผลิตล็อกจะเปิดเผยอินเทอร์เฟซที่ตั้งโปรแกรมได้ในสองชั้น cloud API โดยทั่วไปเป็นบริการแนว REST ผ่าน HTTPS แอปจะยืนยันตัวตนด้วยข้อมูลรับรองแนว OAuth สร้างรหัสผ่านหรือ ekey ส่งคำสั่งปลดล็อกระยะไกลสำหรับล็อกออนไลน์ ตรวจสอบสถานะล็อก และรับ webhook callback สำหรับเหตุการณ์ปลดล็อก แบตเตอรี่ต่ำ และการแทรกแซง mobile SDK เป็นไลบรารีที่ฝังอยู่ในแอป iOS หรือ Android ของผู้ทำการผสานระบบ โดยจัดการการค้นพบ Bluetooth การเชื่อมต่ออย่างปลอดภัย การปลดล็อกในระยะใกล้ และตรรกะข้อมูลรับรองแบบออฟไลน์โดยไม่ต้องส่งคำขอไปยังเซิร์ฟเวอร์และกลับมา การผสานระบบที่ประสบความสำเร็จจะใช้ทั้งสองชั้นอย่างตั้งใจ รักษาความปลอดภัยของข้อมูลรับรอง และทดสอบการจำกัดอัตราและการส่งเหตุการณ์ก่อนเปิดใช้งาน คู่มือนี้อธิบายแนวคิดสำคัญและคำถามที่สำคัญต่อผู้ผลิต โดยการมี API และ SDK ขอบเขตการใช้งาน และเงื่อนไขการอนุญาตใช้งานของแต่ละแพลตฟอร์มจะได้รับการยืนยันเป็นลายลักษณ์อักษรในใบเสนอราคาแต่ละรายการ
| Cloud API | บริการ HTTPS จัดการล็อก ข้อมูลรับรอง และเหตุการณ์จากเซิร์ฟเวอร์ และเข้าถึงประตูระยะไกลได้เฉพาะเมื่อล็อกออนไลน์ผ่าน Wi-Fi หรือเกตเวย์ |
| Mobile SDK | ไลบรารี iOS/Android ที่ฝังอยู่จัดการการเชื่อมต่อ Bluetooth การปลดล็อกในระยะใกล้ และตรรกะออฟไลน์ภายในแอปของผู้ทำการผสานระบบ |
| การยืนยันตัวตน | ข้อมูลรับรองไคลเอนต์แนว OAuth โทเคนตามขอบเขต และ webhook ที่ลงลายเซ็น ช่วยแยกแพลตฟอร์มระดับมืออาชีพออกจากสคริปต์รีเลย์แบบเปิด |
| ข้อมูลรับรองตาม API | การดำเนินการทั่วไปสร้างรหัสผ่านที่มีวันหมดอายุ ekey บัตร และลิงก์สำหรับผู้เยี่ยมชม พร้อม endpoint สำหรับแสดงรายการ อัปเดต และเพิกถอน |
| การส่งเหตุการณ์ | Webhook แจ้งเหตุการณ์ปลดล็อก การใช้รหัส แบตเตอรี่ต่ำ และเหตุการณ์ประตู โดยต้องมีเอกสารระบุพฤติกรรมการลองซ้ำและการรับประกันลำดับเหตุการณ์ |
| การพึ่งพาฮาร์ดแวร์ | คำสั่งระยะไกลทำงานได้เฉพาะบนล็อกออนไลน์ผ่าน Wi-Fi หรือเกตเวย์ ดังนั้นการออกแบบ API และโครงสร้างฮาร์ดแวร์จึงต้องวางแผนควบคู่กัน |
| นโยบายของเรา | เราจัดเตรียมเอกสารอินเทอร์เฟซ สแandbox หรืออุปกรณ์ทดสอบ และช่องทางติดต่อด้านเทคนิค ส่วนข้อมูลรับรองระดับใช้งานจริงและข้อจำกัดต่าง ๆ มาจากข้อตกลงของแพลตฟอร์ม |
ระบบอัตโนมัติฝั่งเซิร์ฟเวอร์ เช่น ช่องทางปล่อยเช่า PMS และการจัดการผู้เยี่ยมชม สร้างบน cloud API ส่วนแอปโทรศัพท์ที่ใช้แบรนด์ของตัวเองและควบคุมในระยะใกล้หรือออฟไลน์จะเพิ่ม mobile SDK ส่วนผลิตภัณฑ์ที่ต้องการทั้งสองแบบควรออกแบบโมเดลข้อมูลรับรองก่อนเริ่มเขียนโค้ด
| เป้าหมายการผสานระบบ | ชุดเครื่องมือหลัก | การพึ่งพาสำคัญ |
|---|---|---|
| ออกรหัสเช่าที่มีวันหมดอายุ | cloud API จากระบบหลังบ้านการจอง | ล็อกต้องรองรับประเภทรหัสเป้าหมายและเส้นทางซิงค์ |
| แอปผู้เช่าแบรนด์ของตัวเอง | mobile SDK ควบคู่กับ cloud API | ทีมแอปต้องดูแลการปล่อย SDK และการตรวจสอบในร้านแอป |
| การส่งคีย์โรงแรมผ่านมือถือ | เหตุการณ์ cloud API จากมิดเดิลแวร์ PMS | บริการข้อมูลรับรองและความครอบคลุมของเกตเวย์ที่ประตู |
| ตู้รับสมัครผู้เยี่ยมชม | cloud API สำหรับข้อมูลรับรองแบบใช้ครั้งเดียว | ต้องตรวจสอบเขตเวลาและหลักการหมดอายุตั้งแต่เริ่มต้น |
| บริการรับเรื่องระยะไกลแบบเรียลไทม์ | การปลดล็อกผ่าน cloud API พร้อมการยืนยันด้วย webhook | เฉพาะล็อกออนไลน์เท่านั้นที่ดำเนินคำสั่งระยะไกลได้ทันที |
| กระเป๋าเงินองค์กรแบบออฟไลน์ | mobile SDK พร้อมข้อมูลรับรองในเครื่องที่ปลอดภัย | กฎการจัดเก็บคีย์และการเพิกถอนบนอุปกรณ์ |
API พบกับความเป็นจริงเชิงกายภาพเมื่อเปิดประตู: เกตเวย์ ประตูโลหะ และระยะการใช้งานแบตเตอรี่เป็นตัวกำหนดว่าการเรียก API ที่สะอาดจะส่งถึงล็อกได้ทันเวลาหรือไม่ ควรทดลองฮาร์ดแวร์และซอฟต์แวร์พร้อมกัน
| จุดเปิด | ประตูทั่วไป | แนวทางการใช้งานล็อก |
|---|---|---|
| ประตูหน่วยเช่า | ล็อก Bluetooth พร้อมเกตเวย์แยกตามพื้นที่ | ระบบหลังบ้านการจองสร้างรหัสแบบออฟไลน์และออนไลน์ผ่าน cloud API |
| ทางเข้าสำนักงานที่เป็นกระจก | เครื่องอ่านหรือตัวควบคุมแบบออนไลน์ | แพลตฟอร์มผู้เยี่ยมชมส่งข้อมูลรับรองแบบใช้ครั้งเดียวและรับ webhook การเข้าใช้ |
| ห้องพักผู้เข้าพักโรงแรม | ล็อก RFID พร้อมบริการคีย์ผ่านมือถือ | มิดเดิลแวร์ PMS เรียกใช้ key API และเกตเวย์ส่งการอัปเดตแบบเรียลไทม์ |
| ประตูพื้นที่ทำงานร่วม | สมาร์ตล็อกที่ติดตั้งหลังอาคารกระจก | แอปสมาชิกฝัง SDK เพื่อปลดล็อกในระยะใกล้แม้แม้ Wi-Fi อ่อน |
| ประตูสำหรับโลจิสติกส์ | ล็อกกลางแจ้งแบบออนไลน์ | คำสั่งระยะไกลต้องการการเชื่อมต่อที่ยืนยันแล้วและช่องทางสำรอง |
| ห้องส่วนสิทธิ์ | ล็อกใช้แบตเตอรี่ที่จัดการระยะไกล | Webhook ตรวจสอบการใช้งานเพื่อการคิดค่าใช้จ่ายและการทบทวนการใช้งานผิดในแอปผู้ให้บริการ |
API อาจดูคล้ายกันในสไลด์ แต่แตกต่างกันในระบบใช้งานจริง ก่อนการลงทุนเวลาด้านวิศวกรรม ผู้ทำการผสานระบบควรรวบรวมรายการต่อไปนี้ ซึ่งเราช่วยประสานงานกับทีมแพลตฟอร์มให้ทั้งหมด
| องค์ประกอบ | ตรรกะทั่วไป | หมายเหตุ |
|---|---|---|
| เอกสารอ้างอิง API | Endpoint ขอบเขต เวอร์ชัน และความพร้อมของ sandbox | การประเมินระยะเวลาพัฒนาขึ้นอยู่กับเอกสารที่ครบถ้วนและเป็นปัจจุบัน |
| แพ็กเกจ SDK | รุ่น OS ที่รองรับ แอปตัวอย่าง และกำหนดการปล่อยรุ่น | ต้องเข้าใจการอนุมัติในร้านแอปและรูปแบบการดูแลรักษา |
| โมเดลความปลอดภัย | ประเภทโทเคน การหมุนเวียนข้อมูลลับ การลงลายเซ็น webhook และตัวเลือก IP | การป้องกัน endpoint ปลดล็อกเป็นสิ่งจำเป็นสำหรับระบบใช้งานจริง |
| ข้อจำกัดและโควตา | การจำกัดอัตรา การแบ่งหน้า การดำเนินการแบบชุด และกฎการลองซ้ำ | มิฉะนั้นการเปิดใช้งานทั้งฟลีตอาจล้มเหลวในช่วงเวลาเช็กอินพีค |
| แคตตาล็อกเหตุการณ์ | ประเภทเหตุการณ์ เพย์โหลด ลำดับ และการรับประกันการส่งซ้ำ | คุณสมบัติตรวจสอบและแจ้งเตือนขึ้นอยู่กับเหตุการณ์ที่เชื่อถือได้ |
API คืออินเทอร์เฟซแบบเซิร์ฟเวอร์ถึงเซิร์ฟเวอร์: แบ็กเอนด์ของคุณเรียกแพลตฟอร์มล็อกผ่าน HTTPS เพื่อสร้างรหัส ส่งคำสั่งปลดล็อกไปยังล็อกออนไลน์ ตรวจสอบสถานะ และรับ webhook เหตุการณ์ โดยไม่ต้องอยู่ใกล้โทรศัพท์ ส่วน SDK สำหรับอุปกรณ์เคลื่อนที่คือไลบรารีซอฟต์แวร์ที่ฝังในแอป iOS หรือ Android ของคุณเอง เพื่อสื่อสารกับล็อกโดยตรงผ่าน Bluetooth ช่วยให้ปลดล็อกใกล้เครื่อง ตั้งค่า และจัดเก็บข้อมูลรับรองแบบออฟไลน์เมื่อไม่สามารถเชื่อมต่อเซิร์ฟเวอร์ได้ แบ็กเอนด์สำหรับงานเช่าและการเชื่อมต่อ PMS ส่วนใหญ่ต้องใช้ cloud API ขณะที่แอปสำหรับผู้เช่าที่ใช้แบรนด์ของตัวเองมักต้องใช้ SDK ร่วมกับการเรียก API เฉพาะบางรายการ การพยายามทำทุกอย่างผ่าน API เช่น ปลดล็อกล็อกที่ใช้ Bluetooth เท่านั้นจากอีกฝั่งของโลกโดยไม่มีเกตเวย์จะไม่สามารถทำได้ ดังนั้น โครงสร้างฮาร์ดแวร์และการเลือกอินเทอร์เฟซจึงต้องได้รับการออกแบบไปด้วยกัน อินเทอร์เฟซที่ใช้ได้ในแต่ละแพลตฟอร์มจะได้รับการยืนยันเป็นลายลักษณ์อักษรในใบเสนอราคาแต่ละรายการ
ได้ นี่เป็นรูปแบบการเชื่อมต่อมาตรฐาน: เมื่อการจองได้รับการยืนยัน แบ็กเอนด์หรือมิดเดิลแวร์ของคุณจะเรียก lock platform API พร้อมข้อมูลห้องหรือยูนิต วันที่เข้าพักและวันที่ออกจากพัก จากนั้นจะได้รับรหัสผ่านหรือ ekey และส่งไปยังผู้เข้าพักผ่านเทมเพลตข้อความหรืออีเมลของคุณเอง จากนั้น webhook จะยืนยันการใช้งานและแจ้งเตือนเหตุการณ์ต่าง ๆ เช่น ความพยายามเช็กอินก่อนเวลาหรือแบตเตอรี่ต่ำ ข้อกำหนดที่ต้องกำหนดให้ชัดเจน ได้แก่ การจัดการเขตเวลาสำหรับช่วงวันที่ ประเภทรหัสที่ใช้งานออฟไลน์ได้กับล็อกที่เลือก ความครอบคลุมของเกตเวย์เพื่อยกเลิกสิทธิ์แบบเรียลไทม์ การลองส่งซ้ำแบบ idempotent เมื่อมีการส่งข้อความซ้ำ และวิธีอัปเดตข้อมูลรับรองเมื่อมีการยกเลิกหรือเปลี่ยนวันที่ เราจัดหาล็อกสำหรับทดสอบและสนับสนุนการอบรมเชิงปฏิบัติการเรื่องการเชื่อมต่อ รายละเอียดของ endpoint ข้อจำกัดอัตรา และสิทธิ์ให้ใช้งานสำหรับแต่ละแพลตฟอร์มจะได้รับการยืนยันเป็นลายลักษณ์อักษรในใบเสนอราคาแต่ละรายการ
การปลดล็อกจากระยะไกลจะปลอดภัยเมื่อแพลตฟอร์มได้รับการพัฒนาเหมือน API ทางการเงินที่มีการยืนยันตัวตน: โทเคนแบบ OAuth ที่มีขอบเขตจำกัด การจัดเก็บ secret ฝั่งเซิร์ฟเวอร์ สิทธิ์แยกตามหน้าที่ของพนักงาน การยืนยันคำสั่งผ่าน webhook บันทึกการตรวจสอบ และการอนุมัติแบบสองปัจจัยสำหรับประตูที่มีข้อกำหนดเข้มงวดเป็นทางเลือก การปลดล็อกจากระยะไกลจะอันตรายเมื่อผู้ติดตั้งระบบฝัง secret ที่มีอายุยาวนานในแอปโทรศัพท์ เปิดเผย relay endpoint ที่ไม่มีการป้องกัน หรือบันทึก URL การปลดล็อกไว้ มาตรการป้องกันทางกายภาพก็สำคัญเช่นกัน: คำสั่งจากระยะไกลจะส่งถึงเฉพาะล็อกออนไลน์ และประตูที่มีความปลอดภัยสูงมักปิดใช้งานการปลดล็อกจากระยะไกลทั้งหมดหรือกำหนดให้ต้องมีการอนุมัติสองด้าน ในขั้นตอนตรวจสอบความเหมาะสม ให้ขอเอกสารข้อมูลด้านความปลอดภัย ขั้นตอนการหมุนโทเคน และรูปแบบการลงลายเซ็น webhook แทนการรับคำกล่าวอ้างเพียงอย่างเดียวว่า “มี REST API ให้ใช้งาน” เราประสานการตรวจสอบดังกล่าวร่วมกับทีมแพลตฟอร์มและสามารถเสนอสถาปัตยกรรมที่จำกัดการปลดล็อกจากระยะไกลไว้เฉพาะบทบาทฝ่ายส reception
webhook คือช่องทางส่งเหตุการณ์มาตรฐาน ได้แก่ บันทึกการปลดล็อก การป้อนรหัส แบตเตอรี่ต่ำ การแจ้งเตือนการแทรกแซง และการเปลี่ยนแปลงของเซ็นเซอร์ประตู แต่หลักการการส่งมอบแตกต่างกันไปตามแพลตฟอร์ม แพลตฟอร์มระดับมืออาชีพจะลงลายเซ็น payload ลองส่งใหม่เมื่อการส่งล้มเหลวโดยใช้ backoff และจัดให้มี API สำหรับกระทบยอดหรือสำรวจเหตุการณ์ที่พลาด ซึ่งสำคัญเนื่องจากเครือข่ายอาจล้มเหลวชั่วคราว และการส่งซ้ำถือเป็นเรื่องปกติ ดังนั้น ผู้ใช้งานต้องถือว่า event ID เป็น idempotent การรับประกันลำดับเหตุการณ์มีข้อจำกัดมากกว่า: เหตุการณ์สองรายการที่เกิดห่างกันเพียงไม่กี่วินาทีอาจมาถึงในลำดับกลับกันได้เป็นครั้งคราว ตรรกะการตรวจสอบจึงควรใช้เวลาเหตุการณ์จากล็อกเป็นเวลาtimestamp แทนเวลาที่มาถึง ในช่วงทดลอง ให้จำลองผู้รับที่ออฟไลน์และตรวจสอบพฤติกรรมการส่งซ้ำ แคตตาล็อกเหตุการณ์ นโยบายการลองใหม่ และ endpoint สำหรับกระทบยอดของแพลตฟอร์มแต่ละรายการจะมีเอกสารระบุไว้เป็นลายลักษณ์อักษรก่อนเริ่มการพัฒนา
สิทธิ์เข้าใช้ API จะได้รับจากแพลตฟอร์มล็อกภายใต้ข้อกำหนดด้านนักพัฒนาและการค้าของแพลตฟอร์มนั้น โดยทั่วไปให้แก่เจ้าของบัญชี ได้แก่ แบรนด์หรือผู้ประกอบการที่เป็นเจ้าของโครงการคลาวด์ ไม่ใช่ผู้ซื้อล็อกทุกรายโดยอัตโนมัติ โรงงานสามารถช่วยเปิดใช้งานบริการ จัดหาเอกสาร และประสานการแนะนำทางด้านเทคนิคได้ แต่ไม่สามารถมอบสิทธิ์ที่เกินข้อตกลงของแพลตฟอร์มได้ แพลตฟอร์มบางแห่งแยกผู้ใช้เฉพาะแอป บัญชีธุรกิจที่มีแดชบอร์ด และพันธมิตรนักพัฒนาที่ได้รับการรับรองซึ่งเข้าถึง API ได้เต็มรูปแบบ อีกทั้ง endpoint ขั้นสูงบางรายการอาจต้องผ่านการตรวจสอบการเชื่อมต่อและได้รับอนุมัติ ดังนั้น ผู้ซื้อที่วางแผนเชื่อมต่อเชิงลึกควรยืนยันสิทธิ์ของนักพัฒนา ค่าธรรมเนียม เงื่อนไขการประมวลผลข้อมูล และภูมิภาคที่รองรับก่อนเลือกฮาร์ดแวร์ เพราะล็อกที่ดีเยี่ยมแต่ไม่มีสิทธิ์ใช้ API ก็ไม่สามารถขับเคลื่อนผลิตภัณฑ์ตามแผนได้ โครงการนักพัฒนาและสิทธิ์ให้ใช้งานปัจจุบันของแต่ละแพลตฟอร์มจะได้รับการยืนยันในแต่ละ RFQ
แจ้งกรณีการใช้งานการเชื่อมต่อ เทคโนโลยีที่ทีมของคุณใช้ และกำหนดการเปิดตัวพร้อมกับ RFQ ของคุณ เราประสานเอกสาร API แพ็กเกจ SDK อุปกรณ์ทดสอบ และข้อตกลงกับแพลตฟอร์ม พร้อมสนับสนุนการทดลองร่วมกันที่ครอบคลุมการทำงานออฟไลน์ การลองใหม่ และเหตุการณ์ในระดับกลุ่มอุปกรณ์
ขอข้อมูลสเปกและใบเสนอราคาภาพรวมเทคโนโลยีปรับปรุงล่าสุด: 31 ตุลาคม 2026 · ตรวจสอบโดยทีมบรรณาธิการของ Smart Lock Factory