Support Hub/API & Integrations/Native Push बनाम Hybrid Modes: तकनीकी निर्णय वृक्ष
Translated from the English article and reviewed by a person. Read the English original
Developer

Native Push बनाम Hybrid Modes: तकनीकी निर्णय वृक्ष

Native Push बनाम Hybrid Modes: तकनीकी निर्णय वृक्ष

Cams Biometric Gateway से जुड़ने वाला हर बायोमेट्रिक डिवाइस दो push modes में से किसी एक के माध्यम से जुड़ता है। आपका डिवाइस जिस mode का उपयोग करता है, वही तय करता है कि कौन-से APIs उपलब्ध हैं, events कैसे भेजे जाते हैं, और आपके infrastructure को कैसे configure करना होगा। यह गाइड निर्णय के हर चर को समझाती है, जिसमें डिवाइस के प्रकार से लेकर communication method और deployment topology तक शामिल हैं, ताकि आप निर्माण शुरू करने से पहले सही रास्ता चुन सकें।

पहला प्रश्न: आप किस प्रकार का डिवाइस जोड़ रहे हैं?

कोई communication method या deployment topology चुनने से पहले एक अधिक मूलभूत प्रश्न का उत्तर देना होगा: क्या आपका डिवाइस Cams Biometrics डिवाइस है, या Cams developer portal पर verified डिवाइस है?

इस प्रश्न का उत्तर पूरी तरह से आपका push mode तय करता है। यदि उत्तर हाँ है, तो आप Native Push का उपयोग करते हैं और आगे किसी निर्णय की आवश्यकता नहीं है। यदि उत्तर नहीं है, तो आप Hybrid Push के दायरे में आते हैं, और इसके बाद कुछ अतिरिक्त निर्णय लेने होते हैं।

मोड 1
Native Push
सभी Cams Biometrics मशीनों और developer.camsbiometrics.com पर verified के रूप में सूचीबद्ध किसी भी डिवाइस के लिए। डिवाइस इंटरनेट के माध्यम से सीधे Biometric Gateway से संवाद करता है, और किसी अतिरिक्त setup की आवश्यकता नहीं होती।

सभी 38 ऑपरेशन
पूर्ण Callback API
पूर्ण RESTful API

मोड 2
Hybrid Push
अन्य सभी गैर-verified डिवाइसों के लिए। आप एक communication method और deployment topology चुनते हैं जो आपके वातावरण में उपयुक्त हो। API की उपलब्धता आपके द्वारा चुने गए संयोजन पर निर्भर करती है।

3 communication methods
2 topology options
अलग-अलग API access

Native Push: पूरी तस्वीर

Native Push डिवाइसों को सभी 38 Gateway ऑपरेशनों तक पूर्ण पहुँच मिलती है, और डिवाइस को इंटरनेट से जोड़ने के अलावा किसी अतिरिक्त configuration की आवश्यकता नहीं होती। Callback API शून्य latency के साथ events भेजता है। RESTful API commands लगभग 15 सेकंड में execute होते हैं। कोई SDK, कोई local software और कोई topology निर्णय आवश्यक नहीं है।

Hybrid Push को समझना: तीन Communication Methods

यदि आपका डिवाइस Cams या verified डिवाइस नहीं है, तो अगला निर्णय यह है कि Gateway वास्तव में आपके hardware से कैसे संवाद करेगा। तीन communication methods उपलब्ध हैं, और प्रत्येक की आवश्यकताएँ अलग हैं और यह भी अलग तरह से प्रभावित करती है कि आप कौन-से API फीचर उपयोग कर सकते हैं।

Communication method का संबंध आपके network configuration से नहीं है। यह उस तकनीकी तंत्र से संबंधित है जिसके द्वारा Gateway आपके विशिष्ट डिवाइस से डेटा पढ़ता है और उसे commands भेजता है। यह चुनाव इस बात से सीमित होता है कि आपका hardware क्या समर्थन करता है।

a
Device SDK
पूर्ण API access के लिए सर्वोत्तम विकल्प
Gateway डिवाइस निर्माता के SDK का उपयोग करके hardware से संवाद करता है। SDK निम्न-स्तरीय device protocol को संभालता है, और Gateway SDK द्वारा समर्थित सभी फीचर अपने API के माध्यम से उपलब्ध कराता है। Hybrid Push में यही एकमात्र communication method है जो RESTful API ऑपरेशनों को सक्षम करता है।
पूर्ण Callback API + पूर्ण RESTful API (SDK क्षमताओं के भीतर)
b
DB Pull
केवल attendance डेटा
Gateway एक local database से पढ़ता है, जिसमें डिवाइस का अपना management software attendance records लिखता है। Gateway इस database की निगरानी करता है और नए records को वास्तविक समय में आपके callback URL पर भेजता है। डिवाइस के साथ कोई सीधा संचार नहीं होता, जिसका अर्थ है कि डिवाइस को कोई commands नहीं भेजे जा सकते। Users जोड़ना, records हटाना, या logs लोड करना जैसे ऑपरेशन उपलब्ध नहीं हैं।
Callback API: केवल attendance और punch logs। RESTful API: समर्थित नहीं।
c
File Processing
केवल attendance डेटा
स्थानीय कंप्यूटर पर एक निर्धारित attendance file की लगातार निगरानी की जाती है। हर बार जब डिवाइस software इस file को नए attendance records के साथ अपडेट करता है, Gateway परिवर्तन का पता लगाता है, नए records निकालता है, और उन्हें वास्तविक समय में आपके callback URL पर भेजता है। DB Pull की तरह, यह method डिवाइस के दृष्टिकोण से केवल-पढ़ने योग्य है और वही API सीमाएँ रखती है।
Callback API: केवल attendance और punch logs। RESTful API: समर्थित नहीं।
Communication method कैसे चुनें

यदि आपके डिवाइस के पास निर्माता का SDK है जो Cams Gateway द्वारा समर्थित है, तो Device SDK (a) चुनें। यह एकमात्र method है जो Hybrid Push डिवाइसों के लिए RESTful API ऑपरेशन अनलॉक करता है। यदि SDK समर्थित नहीं है या उपलब्ध नहीं है, तो DB Pull (b) या File Processing (c) फिर भी attendance डेटा को वास्तविक समय में आपके callback endpoint तक पहुँचाएँगे, जो कई उपयोग मामलों के लिए पर्याप्त है।

Hybrid Push को समझना: दो Deployment Topologies

एक बार communication method चुन लेने के बाद, दूसरा निर्णय यह है कि Gateway आपके डिवाइस, database या file से कहाँ जुड़ता है। यह topology निर्णय है, और यह डिवाइस के भौतिक स्थान पर आपके network वातावरण पर निर्भर करता है।

Topology X

Direct
वह site computer जिससे डिवाइस जुड़ा है, या जहाँ device management software चलता है, उसके पास port forwarding के साथ एक public IP address होता है जो local network की ओर कॉन्फ़िगर किया गया है। Biometric Gateway इंटरनेट के माध्यम से सीधे डिवाइस, database या files से जुड़ता है।
आवश्यक: site पर public IP + port forwarding
Topology Y

Indirect
स्थानीय site computer पर एक Hybrid Connector application इंस्टॉल किया जाता है। यह स्थानीय मशीन और Biometric Gateway के बीच एक outbound bridge के रूप में कार्य करता है, और अंदर से कनेक्शन स्थापित करता है, न कि किसी inbound connection की आवश्यकता होती है। ग्राहक की ओर किसी public IP की आवश्यकता नहीं है।
आवश्यक: स्थानीय computer पर Hybrid Connector इंस्टॉल हो। कोई public IP आवश्यक नहीं।
Topology सुझाव

यदि आप site पर public IP या port forwarding कॉन्फ़िगर नहीं कर सकते, तो Hybrid Connector के साथ Indirect topology (Y) चुनें। यह सबसे सरल deployment मार्ग है और ग्राहक की ओर network configuration की आवश्यकता पूरी तरह से टाल देता है। यदि public IP उपलब्ध और कॉन्फ़िगर है, तो Direct topology (X) भी काम करती है और site पर किसी अतिरिक्त software इंस्टॉलेशन की आवश्यकता नहीं होती।

निर्णय वृक्ष: आपको कौन-सा Mode चुनना चाहिए?

इस निर्णय वृक्ष को ऊपर से नीचे तक पढ़ें। पहले उत्तर पर रुकें जो आपकी स्थिति पर लागू होता है।

निर्णय वृक्ष, ऊपर से शुरू करें
1. क्या आपका डिवाइस Cams Biometrics डिवाइस है, या developer.camsbiometrics.com पर verified के रूप में सूचीबद्ध है?
हाँ उपयोग करें Native Push। पूर्ण API access। आगे कोई निर्णय आवश्यक नहीं।
नहीं प्रश्न 2 पर जाएँ।
2. क्या Cams Gateway आपके डिवाइस निर्माता के SDK को समर्थन देता है?
हाँ उपयोग करें Hybrid Push, Device SDK (a)। SDK सीमाओं के भीतर पूर्ण Callback और RESTful API access। topology के लिए प्रश्न 3 पर जाएँ।
नहीं प्रश्न 2b पर जाएँ।
2b. क्या आपका device management software attendance records को एक local database में लिखता है?
हाँ उपयोग करें Hybrid Push, DB Pull (b)। केवल Attendance Callback। topology के लिए प्रश्न 3 पर जाएँ।
3. क्या site computer के पास port forwarding के साथ public IP address उपलब्ध है?
हाँ उपयोग करें Direct topology (X)। site पर किसी अतिरिक्त software की आवश्यकता नहीं।
नहीं उपयोग करें Indirect topology (Y)। स्थानीय site computer पर Hybrid Connector इंस्टॉल करें।

Hybrid Push फीचर उपलब्धता मैट्रिक्स

नीचे दी गई तालिका communication method और deployment topology के हर संयोजन को दिखाती है, और हर स्थिति में कौन-से API फीचर उपलब्ध हैं। अपने चुने हुए configuration द्वारा समर्थित चीज़ों की पुष्टि के लिए इसे निर्णय वृक्ष के साथ उपयोग करें।

मोड Communication Topology Callback API RESTful API
प्रत्यक्ष डिवाइस (a) Device SDK (X) Public IP पूर्ण पूर्ण (SDK सीमाएँ लागू)
अप्रत्यक्ष डिवाइस (a) Device SDK (Y) Hybrid Connector पूर्ण पूर्ण (SDK सीमाएँ लागू)
प्रत्यक्ष DB (b) DB Pull (X) Public IP केवल attendance समर्थित नहीं
अप्रत्यक्ष DB (b) DB Pull (Y) Hybrid Connector केवल attendance समर्थित नहीं
प्रत्यक्ष फ़ाइल (c) File Processing (X) Public IP केवल attendance समर्थित नहीं
अप्रत्यक्ष फ़ाइल (c) File Processing (Y) Hybrid Connector केवल attendance समर्थित नहीं
महत्वपूर्ण hardware चेतावनी

Hardware सीमाएँ Device SDK mode के भीतर भी API फीचर को और सीमित कर सकती हैं। डिवाइस मॉडल के firmware संस्करण या निर्माता के SDK द्वारा उजागर की गई क्षमताओं के आधार पर कुछ APIs काम न करें। ऊपर दी गई मैट्रिक्स यह बताती है कि Gateway architecture क्या समर्थित करता है, न कि यह कि हर व्यक्तिगत डिवाइस मॉडल किन चीज़ों की गारंटी देता है। production deployment से पहले हमेशा अपने विशिष्ट hardware पर परीक्षण करें और किसी भी edge case की पुष्टि Cams support team से करें।

Topology निर्णय क्या प्रभावित करता है और क्या नहीं

topology और API उपलब्धता के बीच का संबंध अक्सर भ्रम का कारण बनता है। topology चुनाव, चाहे Direct हो या Indirect, यह प्रभावित नहीं करता कि कौन-से API फीचर उपलब्ध हैं। API फीचर सेट पूरी तरह communication method द्वारा निर्धारित होता है।

topology जो प्रभावित करता है वह यह है कि Gateway और आपके स्थानीय वातावरण के बीच network कनेक्शन कैसे स्थापित होता है। Direct topology के लिए site पर public IP और port forwarding आवश्यक है। Indirect topology के लिए स्थानीय मशीन पर Hybrid Connector इंस्टॉल होना आवश्यक है। आपके लिए उपलब्ध API फीचर Direct Device SDK और Indirect Device SDK के लिए समान हैं, और Direct DB Pull और Indirect DB Pull के लिए भी समान हैं।

“अपनी communication method इस आधार पर चुनें कि आपके integration को किन API फीचर की आवश्यकता है। अपनी topology इस आधार पर चुनें कि आपका network वातावरण क्या समर्थित करता है। ये स्वतंत्र निर्णय हैं।”

अक्सर पूछे जाने वाले प्रश्न

क्या मैं DB Pull या File Processing के साथ RESTful API commands का उपयोग कर सकता हूँ?
नहीं। DB Pull और File Processing केवल-पढ़ने योग्य integration methods हैं। ये Gateway को डिवाइस के अपने software द्वारा उत्पन्न attendance डेटा देखने की अनुमति देते हैं, लेकिन ये ऐसा कोई चैनल स्थापित नहीं करते जिसके माध्यम से डिवाइस को commands वापस भेजे जा सकें। उपयोगकर्ता जोड़ना, records हटाना, या logs लोड करना जैसे RESTful API ऑपरेशनों के लिए Device SDK mode आवश्यक है, जो एक द्विदिशीय संचार चैनल बनाता है।
क्या Hybrid Connector को उसी मशीन पर इंस्टॉल करना आवश्यक है जहाँ डिवाइस software है?
हाँ। Hybrid Connector को उसी स्थानीय computer पर इंस्टॉल होना चाहिए जिससे डिवाइस जुड़ा है, या जहाँ device management software चलता है। ऐसा इसलिए है क्योंकि आपके communication method के आधार पर इसे डिवाइस, स्थानीय database, या attendance file तक स्थानीय पहुँच की आवश्यकता होती है। इसके बाद Connector Gateway तक एक outbound tunnel बनाता है, जिससे उस स्थान पर public IP की आवश्यकता समाप्त हो जाती है।
Native Push और Hybrid Push के बीच latency में क्या अंतर है?
Native Push के लिए, Callback API events शून्य latency के साथ भेजे जाते हैं और RESTful API commands लगभग 30 सेकंड में execute होते हैं। Device SDK का उपयोग करने वाले Hybrid Push के लिए, latency SDK के अपने संचार चक्र पर निर्भर करती है और डिवाइस निर्माता के अनुसार भिन्न होती है। DB Pull और File Processing की latency इस बात पर निर्भर करती है कि स्थानीय software कितनी बार नए records लिखता है और Gateway परिवर्तन का पता कितनी जल्दी लगाता है, आमतौर पर डिवाइस द्वारा घटना दर्ज करने के कुछ सेकंड के भीतर।

निष्कर्ष: अपने Mode को अपनी बाधाओं से मिलाएँ

Cams Biometric Gateway के लिए connection mode का निर्णय पसंद का प्रश्न नहीं है। यह बाधाओं का प्रश्न है। यदि आपका डिवाइस योग्य है तो Native Push सही उत्तर है, क्योंकि यह न्यूनतम configuration के साथ अधिकतम क्षमता देता है। बाकी सभी स्थितियों के लिए Hybrid Push उत्तर है, और इसके भीतर, Device SDK mode API access के मामले में Native Push के सबसे निकट का विकल्प देता है।

जब पूर्ण SDK access उपलब्ध न हो, तो DB Pull और File Processing व्यावहारिक मार्ग हैं जो फिर भी attendance डेटा को वास्तविक समय में आपके systems तक पहुँचाते हैं। topology निर्णय तब एक अलग, infrastructure-स्तर का चुनाव है जो यह नहीं बदलता कि API क्या कर सकता है।

निर्णय वृक्ष से शुरू करें, फीचर मैट्रिक्स के विरुद्ध अपने चुनाव की पुष्टि करें, अपने hardware पर परीक्षण करें, और production में जाने से पहले किसी भी edge case की पुष्टि Cams support team से करें।

Was this article helpful?