
लॉक को किसी ऐप, PMS या बिल्डिंग प्लेटफ़ॉर्म से जोड़ना दो अलग टूल सेट के माध्यम से होता है: रिमोट संचालन के लिए क्लाउड API और निकटवर्ती फ़ोन नियंत्रण के लिए Bluetooth SDK। इन दोनों को भ्रमित करना एकीकरण योजना का सबसे सामान्य त्रुटि है।
जब किसी तीसरे पक्ष के एप को स्मार्ट लॉक संचालित करने की आवश्यकता हो—जैसे कोड जारी करने वाला किराया चैनल, आगंतुकों को क्रेडेंशियल देने वाला ऑफ़िस प्लेटफ़ॉर्म या मोबाइल की देने वाला होटल ऐप—तो लॉक विक्रेता दो स्तरों में प्रोग्राम करने योग्य इंटरफ़ेस उपलब्ध कराता है। क्लाउड API आमतौर पर HTTPS पर REST-शैली सेवा होता है: एप OAuth-शैली क्रेडेंशियल से प्रमाणित होता है, पासकोड या ekey बनाता है, ऑनलाइन लॉक के लिए रिमोट अनलॉक कमांड भेजता है, लॉक की स्थिति की जाँच करता है और अनलॉक, कम बैटरी तथा टैम्पर घटनाओं के लिए webhook कॉलबैक प्राप्त करता है। मोबाइल SDK एक लाइब्रेरी है जो एकीकर्ता के अपने iOS या Android ऐप में एम्बेड होती है और Bluetooth खोज, सुरक्षित कनेक्शन, निकटवर्ती अनलॉक तथा ऑफ़लाइन क्रेडेंशियल लॉजिक को बिना किसी सर्वर राउंड-ट्रिप के संभालती है। सफल एकीकरण दोनों स्तरों का जानबूझकर उपयोग करते हैं, अपने क्रेडेंशियल सुरक्षित रखते हैं और लॉन्च से पहले रेट लिमिट तथा घटना वितरण की जाँच करते हैं। यह गाइड महत्वपूर्ण अवधारणाओं और विक्रेता से पूछे जाने वाले प्रश्नों की मानचित्रणा करती है। प्रत्येक प्लेटफ़ॉर्म के लिए API और SDK की उपलब्धता, स्कोप तथा लाइसेंसिंग की पुष्टि प्रत्येक कोटेशन में लिखित रूप से की जाती है।
| क्लाउड API | HTTPS सेवाएँ सर्वर से लॉक, क्रेडेंशियल और घटनाओं को प्रबंधित करती हैं; लॉक Wi-Fi या गेटवे के माध्यम से ऑनलाइन होने पर ही रिमोट दरवाज़ों तक पहुँचती हैं। |
| मोबाइल SDK | एम्बेडेड iOS/Android लाइब्रेरी एकीकर्ता के अपने ऐप में Bluetooth कनेक्शन, निकटवर्ती अनलॉक और ऑफ़लाइन लॉजिक संभालती हैं। |
| प्रमाणीकरण | OAuth-शैली क्लाइंट क्रेडेंशियल, सीमित-स्कोप टोकन और हस्ताक्षरित webhook पेशेवर प्लेटफ़ॉर्म को ओपन रिले स्क्रिप्ट से अलग करते हैं। |
| API के अनुसार क्रेडेंशियल | सामान्य संचालनों में तारीख वाले पासकोड, ekey, कार्ड और आगंतुक लिंक बनाए जाते हैं, जिनके लिए सूची, अपडेट और रद्दीकरण एंडपॉइंट होते हैं। |
| घटना वितरण | Webhook अनलॉक, कोड उपयोग, कम बैटरी और दरवाज़े की घटनाओं की सूचना देते हैं; पुनःप्रयास व्यवहार और क्रम की गारंटी के दस्तावेज़ होने चाहिए। |
| हार्डवेयर निर्भरता | रिमोट कमांड केवल Wi-Fi या गेटवे के माध्यम से ऑनलाइन लॉक पर ही निष्पादित होते हैं, इसलिए API डिज़ाइन और हार्डवेयर टोपोलॉजी को एक साथ योजनाबद्ध करना चाहिए। |
| हमारी नीति | हम इंटरफ़ेस दस्तावेज़, सैंडबॉक्स या टेस्ट डिवाइस और तकनीकी संपर्क उपलब्ध कराते हैं; प्रोडक्शन क्रेडेंशियल और सीमाएँ प्लेटफ़ॉर्म समझौते से प्राप्त होती हैं। |
सर्वर-साइड ऑटोमेशन (किराया चैनल, PMS, आगंतुक प्रबंधन) क्लाउड API पर आधारित होता है; ब्रांडेड फ़ोन ऐप जिनमें निकटवर्ती या ऑफ़लाइन नियंत्रण होता है, उन्हें मोबाइल SDK जोड़ता है। जिन उत्पादों को दोनों की आवश्यकता हो, उन्हें कोड लिखने से पहले क्रेडेंशियल मॉडल डिज़ाइन करना चाहिए।
| एकीकरण लक्ष्य | प्राथमिक टूल सेट | मुख्य निर्भरता |
|---|---|---|
| तारीख वाले किराया कोड जारी करना | बुकिंग बैकएंड से क्लाउड API | लॉक लक्षित कोड प्रकार और सिंक मार्ग का समर्थन करते हैं। |
| ब्रांडेड किरायेदार ऐप | मोबाइल SDK के साथ क्लाउड API | ऐप टीम SDK रिलीज़ और स्टोर समीक्षा संभालती है। |
| होटल मोबाइल कुंजी वितरण | PMS मिडलवेयर से क्लाउड API घटनाएँ | दरवाज़ों पर क्रेडेंशियल सेवा और गेटवे की कवरेज। |
| आगंतुक प्रबंधन कियोस्क | एकबारगी क्रेडेंशियल के लिए क्लाउड API | समय क्षेत्रों और समाप्ति की अवधारणाओं का शीघ्र सत्यापन। |
| लाइव रिमोट कंसीयज | क्लाउड API अनलॉक के साथ webhook पुष्टि | केवल ऑनलाइन लॉक रिमोट कमांड तुरंत निष्पादित करते हैं। |
| ऑफ़लाइन एंटरप्राइज़ वॉलेट | सुरक्षित स्थानीय क्रेडेंशियल के साथ मोबाइल SDK | डिवाइस पर कुंजी भंडारण और रद्दीकरण नियम। |
API का सामना करना प्रारंभिक स्थिति में वास्तविक दुनिया से होता है: गेटवे, धातु के दरवाज़े और बैटरी की अवधि तय करती हैं कि साफ़ API कॉल समय पर लॉक तक पहुँचेगी या नहीं। पायलट हार्डवेयर और सॉफ़्टवेयर को एक साथ आज़माएँ।
| आरंभिक स्थिति | सामान्य दरवाज़ा | लॉक का दृष्टिकोण |
|---|---|---|
| किराया इकाई का दरवाज़ा | प्रति क्षेत्र गेटवे के साथ Bluetooth लॉक | बुकिंग बैकएंड क्लाउड API के माध्यम से ऑफ़लाइन और ऑनलाइन कोड बनाता है। |
| ऑफ़िस का काँच का प्रवेश द्वार | ऑनलाइन रीडर या कंट्रोलर | आगंतुक प्लेटफ़ॉर्म एकबारगी क्रेडेंशियल भेजता है और प्रवेश webhook प्राप्त करता है। |
| होटल अतिथि कक्ष | मोबाइल-कुंजी सेवा के साथ RFID लॉक | PMS मिडलवेयर key API को कॉल करता है; गेटवे लाइव अपडेट भेजता है। |
| को-वर्किंग दरवाज़ा | काँच की आवरण के पीछे स्मार्ट लॉक | सदस्य ऐप कमज़ोर Wi-Fi पर भी निकटवर्ती अनलॉक के लिए SDK एम्बेड करता है। |
| लॉजिस्टिक्स गेट | आउटडोर ऑनलाइन लॉक | रिमोट कमांड के लिए पुष्ट किए गए कनेक्टिविटी और फ़ॉलबैक संपर्क आवश्यक हैं। |
| सुविधा कक्ष | रिमोट रूप से प्रबंधित बैटरी लॉक | ऑपरेटर ऐप में बिलिंग और दुरुपयोग समीक्षा के लिए webhook ऑडिट का उपयोग होता है। |
स्लाइड्स में API एक जैसे दिखते हैं, लेकिन प्रोडक्शन में अलग होते हैं। इंजीनियरिंग का समय समर्पित करने से पहले एकीकर्ताओं को नीचे दी गई सामग्री इकट्ठी करनी चाहिए, जिसके समन्वय में हम प्लेटफ़ॉर्म टीम की मदद करते हैं।
| घटक | सामान्य लॉजिक | टिप्पणियाँ |
|---|---|---|
| API संदर्भ | एंडपॉइंट, स्कोप, संस्करण और सैंडबॉक्स की उपलब्धता। | इंजीनियरिंग के अनुमान पूर्ण और अद्यतन दस्तावेज़ों पर निर्भर हैं। |
| SDK पैकेज | समर्थित OS संस्करण, नमूना ऐप और रिलीज़ ताल। | स्टोर स्वीकृति और रखरखाव मॉडल को समझना आवश्यक है। |
| सुरक्षा मॉडल | टोकन प्रकार, सीक्रेट रोटेशन, webhook साइनिंग और IP विकल्प। | प्रोडक्शन के लिए अनलॉक एंडपॉइंट की सुरक्षा अनिवार्य है। |
| सीमाएँ और कोटा | रेट लिमिट, पेजिनेशन, बैच संचालन और पुनःप्रयास नियम। | अन्यथा फ़्लीट लॉन्च चेक-इन के व्यस्त समय में विफल हो सकती है। |
| घटना कैटलॉग | घटना प्रकार, पेलोड, क्रम और पुनःवितरण की गारंटी। | ऑडिट और सूचना सुविधाएँ विश्वसनीय घटनाओं पर निर्भर हैं। |
API एक सर्वर-टू-सर्वर इंटरफ़ेस है: आपका बैकएंड HTTPS के माध्यम से लॉक प्लेटफ़ॉर्म को कॉल करके कोड बनाता है, ऑनलाइन लॉक को अनलॉक कमांड भेजता है, स्थिति की जानकारी लेता है और वेबहुक इवेंट प्राप्त करता है। यह फ़ोन के निकट होने की आवश्यकता के बिना काम करता है। मोबाइल SDK एक सॉफ़्टवेयर लाइब्रेरी है, जिसे आपके अपने iOS या Android App में शामिल किया जाता है। यह सीधे Bluetooth के माध्यम से लॉक से संवाद करता है, जिससे निकटवर्ती लॉक अनलॉक करना, सेटअप करना और सर्वर उपलब्ध न होने पर ऑफ़लाइन क्रेडेंशियल संग्रहित करना संभव होता है। किराये के बैकएंड और PMS एकीकरणों को मुख्य रूप से क्लाउड API की आवश्यकता होती है; ब्रांडेड टेनेंट App को आमतौर पर SDK के साथ चुनिंदा API कॉल की भी आवश्यकता होती है। सब कुछ API के माध्यम से करने का प्रयास — उदाहरण के लिए, गेटवे के बिना दूसरे देश में केवल Bluetooth वाले लॉक को अनलॉक करना — काम नहीं करेगा, इसलिए हार्डवेयर टोपोलॉजी और इंटरफ़ेस का चयन एक साथ किया जाना चाहिए। प्रत्येक प्लेटफ़ॉर्म के लिए उपलब्ध इंटरफ़ेस हर कोटेशन में लिखित रूप से पुष्ट किए जाते हैं।
हाँ, यह एक मानक एकीकरण पैटर्न है: आरक्षण की पुष्टि होने पर आपका बैकएंड या मिडलवेयर रूम या यूनिट, आगमन और प्रस्थान की जानकारी के साथ लॉक प्लेटफ़ॉर्म API को कॉल करता है और पासकोड या ekey प्राप्त करता है, जिसे आपके अपने संदेश या ईमेल टेम्पलेट के माध्यम से अतिथि को भेजा जाता है। इसके बाद वेबहुक उपयोग की पुष्टि करते हैं और जल्दी चेक-इन के प्रयास या कम बैटरी जैसी घटनाओं को चिह्नित करते हैं। तय करने योग्य आवश्यकताओं में दिनांक अवधियों के लिए समय क्षेत्र का प्रबंधन, चयनित लॉक पर कौन-सा कोड प्रकार ऑफ़लाइन काम करता है, लाइव रद्दीकरण के लिए गेटवे कवरेज, संदेश दोबारा भेजे जाने पर इडेम्पोटेंट पुनःप्रयास, और रद्दीकरण या तिथि बदलने पर क्रेडेंशियल कैसे अपडेट होता है, शामिल हैं। हम टेस्ट लॉक और एकीकरण कार्यशालाओं में सहायता प्रदान करते हैं; एंडपॉइंट विवरण, रेट लिमिट और प्रत्येक प्लेटफ़ॉर्म की लाइसेंसिंग हर कोटेशन में लिखित रूप से पुष्ट की जाती है।
दूर से अनलॉक तब सुरक्षित होता है जब प्लेटफ़ॉर्म को किसी भी प्रमाणित वित्तीय API की तरह बनाया गया हो: सीमित स्कोप वाले OAuth-शैली टोकन, सर्वर-साइड सीक्रेट स्टोरेज, प्रत्येक स्टाफ सदस्य के लिए अनुमतियाँ, वेबहुक द्वारा कमांड की पुष्टि, ऑडिट लॉग और संवेदनशील दरवाज़ों के लिए वैकल्पिक दो-कारक स्वीकृति। यह खतरनाक तब हो जाता है जब एकीकर्ता फ़ोन App में दीर्घकालिक सीक्रेट एम्बेड करते हैं, खुले रिले एंडपॉइंट उजागर करते हैं या अनलॉक URL लॉग करते हैं। भौतिक सुरक्षा भी महत्वपूर्ण है: दूर से भेजे गए कमांड केवल ऑनलाइन लॉक तक पहुँचते हैं, और उच्च सुरक्षा वाले दरवाज़े अक्सर दूर से अनलॉक पूरी तरह अक्षम कर देते हैं या दोहरी स्वीकृति माँगते हैं। ड्यू डिलिजेंस के दौरान केवल “REST API उपलब्ध है” कहने पर भरोसा करने के बजाय सुरक्षा व्हाइटपेपर, टोकन रोटेशन प्रक्रिया और वेबहुक साइनिंग योजना माँगें। हम प्लेटफ़ॉर्म टीम के साथ इन समीक्षाओं का समन्वय करते हैं और ऐसे आर्किटेक्चर प्रस्तावित कर सकते हैं जिनमें दूर से अनलॉक केवल रिसेप्शन भूमिकाओं तक सीमित रहता है।
वेबहुक मानक इवेंट चैनल हैं — अनलॉक रिकॉर्ड, कोड प्रवेश, कम बैटरी, टैम्पर अलर्ट और दरवाज़े के सेंसर में बदलाव — लेकिन डिलीवरी की कार्यशीलता प्लेटफ़ॉर्म के अनुसार बदलती है। पेशेवर प्लेटफ़ॉर्म पेलोड पर हस्ताक्षर करते हैं, असफल डिलीवरी को बैकऑफ़ के साथ दोबारा भेजते हैं और छूटी हुई घटनाओं को मिलाने या पोल करने के लिए API प्रदान करते हैं। यह महत्वपूर्ण है क्योंकि नेटवर्क कभी-कभी संक्षेप रूप से विफल होते हैं और डुप्लिकेट डिलीवरी सामान्य होती है; इसलिए उपभोक्ताओं को इवेंट IDs को इडेम्पोटेंट मानना चाहिए। ऑर्डर की गारंटी कमज़ोर होती है: कुछ सेकंड के अंतर पर बनी दो घटनाएं कभी-कभी उलट क्रम में पहुँच सकती हैं, इसलिए ऑडिट लॉजिक को पहुँचने के समय के बजाय लॉक इवेंट के समय से टाइमस्टैम्प प्राप्त करना चाहिए। पायलट के दौरान ऑफ़लाइन रिसीवर का अनुकरण करें और रीप्ले व्यवहार सत्यापित करें। ऑर्डर्ड प्लेटफ़ॉर्म के लिए इवेंट कैटलॉग, पुनःप्रयास नीति और रिकंसिलिएशन एंडपॉइंट विकास शुरू होने से पहले लिखित रूप से दर्ज किए जाते हैं।
API पहुँच लॉक प्लेटफ़ॉर्म द्वारा उसके अपने डेवलपर और वाणिज्यिक शर्तों के अनुसार दी जाती है, सामान्यतः खाते के मालिक को: यानी क्लाउड प्रोजेक्ट का स्वामिता रखने वाले ब्रांड या ऑपरेटर को, न कि स्वतः हर लॉक खरीदार को। फ़ैक्ट्री सेवा सक्षम करने, दस्तावेज़ उपलब्ध कराने और तकनीकी ऑनबोर्डिंग का समन्वय करने में मदद कर सकती है, लेकिन प्लेटफ़ॉर्म समझौते से आगे अधिकार प्रदान नहीं कर सकती। कुछ प्लेटफ़ॉर्म केवल App उपयोगकर्ताओं, डैशबोर्ड वाले बिज़नेस खातों और पूर्ण API पहुँच वाले प्रमाणित डेवलपर पार्टनरों में अंतर करते हैं, और कुछ उन्नत एंडपॉइंट के लिए अनुमोदित एकीकरण समीक्षा आवश्यक होती है। इसलिए गहरे एकीकरण की योजना बनाने वाले खरीदारों को हार्डवेयर चुनने से पहले डेवलपर पात्रता, शुल्क, डेटा-प्रोसेसिंग शर्तें और समर्थित क्षेत्रों की पुष्टि करनी चाहिए, क्योंकि API अधिकार के बिना एक उत्कृष्ट लॉक योजनाबद्ध उत्पाद को संचालित नहीं कर सकता। प्रत्येक प्लेटफ़ॉर्म के लिए मौजूदा डेवलपर कार्यक्रम और लाइसेंसिंग हर RFQ में पुष्ट की जाती है।
अपने RFQ में एकीकरण उपयोग के मामले, टीम स्टैक और लॉन्च टाइमलाइन साझा करें। हम API दस्तावेज़, SDK पैकेज, टेस्ट डिवाइस और प्लेटफ़ॉर्म समझौतों का समन्वय करते हैं तथा ऑफ़लाइन, पुनःप्रयास और फ़्लीट-स्केल घटनाओं को कवर करने वाले संयुक्त पायलट में सहायता प्रदान करते हैं।
स्पेक शीट और कोटेशन का अनुरोध करेंप्रौद्योगिकी अवलोकनअंतिम अद्यतन: 31 अक्टूबर, 2026 · Smart Lock Factory संपादकीय टीम द्वारा समीक्षित