Support Hub/API & Integrations/वेबहुक बनाम पोलिंग: बायोमेट्रिक डेटा आपके सर्वर तक…
Translated from the English article and reviewed by a person. Read the English original
Developer

वेबहुक बनाम पोलिंग: बायोमेट्रिक डेटा आपके सर्वर तक रियल-टाइम में कैसे पहुँचना चाहिए

वेबहुक बनाम पोलिंग: बायोमेट्रिक डेटा आपके सर्वर तक रियल-टाइम में कैसे पहुँचना चाहिए

हर बायोमेट्रिक इंटीग्रेशन को एक बुनियादी सवाल का जवाब देना होता है: दरवाज़े पर हुआ स्कैन आपके सिस्टम में रिकॉर्ड कैसे बनता है? इसके दो तरीके हैं। आपका सर्वर डिवाइस से लगातार पूछ सकता है कि कुछ नया हुआ है या नहीं, इसे पोलिंग कहते हैं। या सिस्टम कुछ होते ही आपके सर्वर को तुरंत बता सकता है, इसे वेबहुक कहते हैं। बायोमेट्रिक अटेंडेंस और एक्सेस डेटा के लिए, वेबहुक और पोलिंग में से चुनाव इस बात पर असर डालता है कि आपका डेटा कितना ताज़ा है, डिवाइस और नेटवर्क पर कितना लोड पड़ता है, और आपके रिकॉर्ड कितने भरोसेमंद हैं। यह गाइड दोनों तरीकों को सरल शब्दों में समझाती है, बताती है कि बायोमेट्रिक डेटा के लिए वेबहुक बेहतर डिफ़ॉल्ट क्यों हैं, भरोसेमंद वेबहुक रिसीवर कैसे बनाएं, और पोलिंग कहाँ अब भी उपयोगी है, यह बताती है।

01 · पुल बनाम पुश

डेटा पहुँचने के दो तरीके

कल्पना कीजिए कि आप एक ज़रूरी पार्सल का इंतज़ार कर रहे हैं। आप हर पाँच मिनट में सामने के दरवाज़े तक जाकर देख सकते हैं कि वह पहुँचा या नहीं। या आप दरवाज़े की घंटी बजने का इंतज़ार कर सकते हैं। दोनों से पार्सल मिलेगा। पहले तरीके में कई चक्कर बेकार जाते हैं और फिर भी आपको पाँच मिनट तक देर हो सकती है। दूसरा तरीका आपको उसी पल बता देता है कि पार्सल आ गया है।

पोलिंग और वेबहुक के बीच यही अंतर है।

पोलिंग: आपका सर्वर लगातार पूछता रहता है

आपका सर्वर

पूछता है: पिछली बार के बाद कोई नया स्कैन हुआ?

→

डिवाइस या सिस्टम

जवाब देता है: कुछ नया नहीं

→

प्रतीक्षा

पोलिंग अंतराल तक रुकता है

→

दोहराएँ

बार-बार, दिन भर पूछता रहता है

वेबहुक: सिस्टम आपके सर्वर को बताता है

कर्मचारी स्कैन करता है

एक सत्यापित फ़िंगरप्रिंट, चेहरा या कार्ड स्कैन

→

गेटवे

इवेंट को तुरंत आपके वेबहुक URL पर भेजता है

→

आपका सर्वर

इवेंट प्राप्त करता है और done जवाब देता है

→

हो गया

कोई इंतज़ार नहीं और कोई बेकार अनुरोध नहीं

पोलिंग वेबहुक
बातचीत कौन शुरू करता है आपका सर्वर वह सिस्टम जिसके पास डेटा है
डेटा आने पर अगले पोल पर, एक पूरे अंतराल तक देर से स्कैन होते ही तुरंत
कुछ न होने पर भी अनुरोध लगातार, इनमें से ज़्यादातर खाली कोई नहीं
डिवाइस और नेटवर्क पर लोड लगातार, गतिविधि चाहे जो हो केवल तभी जब भेजने के लिए कुछ हो
आपके लिए जटिलता जो पहले ले लिया गया उसका हिसाब रखना इवेंट प्राप्त करना और उनकी पुष्टि करना

02 · छिपी हुई लागतें

बायोमेट्रिक डेटा के साथ पोलिंग क्यों कठिनाई में पड़ती है

पोलिंग उस डेटा के लिए काम करती है जो धीरे बदलता है या जहाँ देरी से फ़र्क नहीं पड़ता। बायोमेट्रिक अटेंडेंस और एक्सेस डेटा इसके ठीक उलट है। यह शिफ्ट शुरू और खत्म होने पर तेज़ बर्स्ट में बनता है, बाकी समय अक्सर शांत रहता है, और इसकी ज़रूरत अक्सर तुरंत पड़ती है।

देरी पहले से तय होती है

पोलिंग में, सबसे खराब स्थिति की देरी हमेशा आपके पोलिंग अंतराल के बराबर होती है। जो स्कैन किसी पोल के एक सेकंड बाद होता है, उसे आपका सर्वर देखने से पहले पूरा अंतराल इंतज़ार करता है।

पोलिंग अंतराल आपके सिस्टम को पता चलने में सबसे लंबी देरी किसके लिए पर्याप्त है
हर 24 घंटे पूरे एक दिन तक केवल मासिक पेरोल
हर घंटे 60 मिनट तक दैनिक रिपोर्ट
हर 5 मिनट 5 मिनट तक ज़्यादातर डैशबोर्ड, अलर्ट नहीं
हर मिनट 60 सेकंड तक लगभग रियल टाइम, पर अनुरोध की ऊँची लागत पर
वेबहुक कोई पोलिंग देरी नहीं लाइव डैशबोर्ड, सूचनाएँ और ऑटोमेशन

ज़्यादातर अनुरोध बेकार जाते हैं

रियल टाइम के करीब पहुँचने के लिए, आप ज़्यादा बार पोल करते हैं। लेकिन उन अनुरोधों में से ज़्यादातर कुछ नहीं लौटाते। एक डिवाइस को हर मिनट पोल करने का मतलब है प्रति डिवाइस प्रतिदिन 1,440 अनुरोध। 50 डिवाइस में यह प्रतिदिन 72,000 अनुरोध हो जाते हैं, जिनमें से ज़्यादातर ऐसा सवाल पूछते हैं जिसका जवाब है “कुछ नया नहीं।” इनमें से हर अनुरोध नेटवर्क क्षमता और डिवाइस के प्रोसेसिंग समय का उपयोग करता है।

हिसाब रखना नाज़ुक हो जाता है

पोलिंग इंटीग्रेशन को यह याद रखना होता है कि उसने पहले क्या ले लिया है, आमतौर पर अंतिम देखे गए रिकॉर्ड का समय या स्थिति सहेजकर। अगर वह निशान गलत हो जाए, जैसे रीस्टार्ट के कारण, सर्वर और डिवाइस के बीच घड़ी के अंतर के कारण, या डिवाइस ऑफ़लाइन रहते समय स्टोर हुए रिकॉर्ड के कारण, तो इंटीग्रेशन या तो स्कैन छोड़ देता है या उन्हें दो बार आयात कर लेता है। ये समस्याएँ चुपचाप होती हैं और अक्सर पेरोल विवाद के समय ही सामने आती हैं।

हर साइट के साथ यह और मुश्किल होता है

एक डिवाइस के साथ पोलिंग संभालने लायक होती है। कई साइटों और ब्रांड में फैले दर्जनों डिवाइस के साथ, जिनमें से हर एक का अपना कनेक्शन, अपना अंतराल और अपना अंतिम-प्राप्त निशान है, पोलिंग अपने आप में एक शेड्यूलिंग और मॉनिटरिंग का काम बन जाती है।

पोलिंग कुछ महत्वपूर्ण पलों को पकड़ने के लिए एक ही सवाल दिन में हज़ारों बार पूछती है। वेबहुक तभी बोलते हैं जब सच में कुछ हुआ हो।

03 · Cams के साथ पुश डिलीवरी

बायोमेट्रिक वेबहुक कैसे काम करते हैं

Cams Biometrics Gateway के साथ, वेबहुक डिलीवरी को Callback API कहा जाता है। आप Gateway को अपने सर्वर पर एक URL देते हैं, और हर सत्यापित स्कैन उसी समय उस URL पर भेजा जाता है। Native Push वाले डिवाइस के लिए Callback इवेंट शून्य विलंब (zero latency) के साथ भेजे जाते हैं।

आपका सर्वर क्या प्राप्त करता है

Callback API, Gateway द्वारा आपके वेबहुक URL पर भेजा गया अनुरोध

{
  "RealTime": {
    "OperationID": "9nu1wak5616p",
    "LabelName": "Burj Khalifa",
    "SerialNumber": "ZHM11xxxxxxxx",
    "PunchLog": {
      "Type": "CheckOut",
      "Temperature": "36.8",
      "FaceMask": false,
      "InputType": "Fingerprint",
      "UserId": "2",
      "LogTime": "2020-09-17 07:48:22 GMT +0530"
    },
    "AuthToken": "COJJ7eiIPBGUfmIQPvh2PJWWDLX7OuKs",
    "Time": "2020-09-17 04:19:03 GMT +0000"
  }
}
फ़ील्ड यह आपके सर्वर को क्या बताता है
OperationID इस इवेंट का एक अनूठा संदर्भ
LabelName वह साइट या दरवाज़ा जिससे डिवाइस जुड़ा है, उसका नाम
SerialNumber वह विशेष डिवाइस जिसने स्कैन दर्ज किया
Type यह चेक-इन था या चेक-आउट
InputType व्यक्ति ने कैसे सत्यापन किया: फ़िंगरप्रिंट, चेहरा, कार्ड, PIN, आदि
UserId किसने स्कैन किया, जो आपके HR सिस्टम के ID से मेल खाता है
LogTime डिवाइस पर स्कैन कब हुआ, उसके टाइम ज़ोन ऑफ़सेट के साथ
AuthToken वह टोकन जिससे आपका सर्वर पुष्टि करता है कि अनुरोध असली है
Time संदेश का अपना टाइमस्टैम्प, GMT में

आपके सर्वर को वापस क्या भेजना होगा

एक बार आपका सर्वर इवेंट प्राप्त कर ले, तो वह एक छोटी पुष्टि (acknowledgement) भेजता है। इससे Gateway को पता चलता है कि इवेंट सुरक्षित पहुँच गया।

Callback API, आपके वेबहुक द्वारा लौटाया जाने वाला जवाब

{ "status": "done" }

डिवाइस खुद न कर सके, तब भी पुश

हर डिवाइस अपने आप डेटा पुश नहीं कर सकता। कुछ पुराने या गैर-सत्यापित डिवाइस अटेंडेंस केवल एक लोकल डेटाबेस या फ़ाइल में रखते हैं। Cams Hybrid Push के साथ, Gateway उस डेटाबेस से पढ़ सकता है (DB Pull) या उस फ़ाइल पर नज़र रख सकता है (File Processing), और फिर भी नए अटेंडेंस रिकॉर्ड आपके Callback URL पर भेज सकता है। भले ही नीचे का डिवाइस आमतौर पर पोल किए जाने की ज़रूरत रखता हो, आपके सर्वर को दोनों ही तरीकों से पुश डिलीवरी मिलती है।

04 · सर्वोत्तम अभ्यास

भरोसेमंद वेबहुक रिसीवर बनाना

वेबहुक रिसीवर बनाना सरल है, लेकिन कुछ अभ्यास ही उस रिसीवर और ऐसे रिसीवर के बीच फ़र्क डालते हैं जो परीक्षण में चलता है और जो सालों तक हर दिन काम करता है।

अभ्यास क्या करें यह क्यों मायने रखता है
पहले पुष्टि करें इवेंट मिलते ही done स्टेटस लौटाएँ, फिर धीमा काम बाद में करें आपके डाउनस्ट्रीम सिस्टम धीमे हों तब भी गेटवे का अनुरोध छोटा रहता है
काम को queue में रखें हर प्राप्त इवेंट को queue या table में रखें, और उसे अलग से प्रोसेस करें शिफ्ट शुरू होने के समय के बर्स्ट को बिना इवेंट गिराए संभालता है
AuthToken सत्यापित करें डेटा पर भरोसा करने से पहले हर अनुरोध का टोकन जाँचें कोई और आपके URL पर नकली अटेंडेंस पोस्ट नहीं कर सकता
HTTPS उपयोग करें वेबहुक को केवल HTTPS पर उपलब्ध कराएँ, Gateway से वैकल्पिक AES-256 एन्क्रिप्शन के साथ अटेंडेंस डेटा व्यक्तिगत डेटा है और ट्रांज़िट में सुरक्षित रहना चाहिए
इसे idempotent बनाएँ OperationID से पहचानें और उन इवेंट्स को अनदेखा करें जो आप पहले ही प्रोसेस कर चुके हैं दोहराई गई डिलीवरी कभी डुप्लिकेट अटेंडेंस रिकॉर्ड नहीं बनती
अटेंडेंस के लिए LogTime पर भरोसा करें अटेंडेंस LogTime से दर्ज करें, उस समय से नहीं जब आपके सर्वर ने इवेंट प्राप्त किया आउटेज के दौरान स्टोर हुए इवेंट बाद में पहुँचते हैं, पर उनका असली स्कैन समय बना रहता है
LogTime से क्रम में लगाएँ घंटे गिनने से पहले इवेंट्स को LogTime के क्रम में लगाएँ कनेक्शन टूटने के बाद बफ़र किए गए इवेंट गलत क्रम में आ सकते हैं
सब कुछ लॉग करें हर प्राप्त इवेंट और भेजे गए हर जवाब का रिकॉर्ड रखें समस्या-निवारण और ऑडिट आसान हो जाते हैं

औसत नहीं, बर्स्ट के लिए योजना बनाएँ

300 कर्मचारियों वाली एक साइट दिन के ज़्यादातर हिस्से में लगभग कुछ नहीं पा सकती, फिर शिफ्ट बदलने के समय दस मिनट में 300 इवेंट आ सकते हैं। अपना रिसीवर उसी चरम स्थिति के लिए डिज़ाइन करें। तेज़ी से पुष्टि करना और काम को queue में डालना इसे संभालने का सबसे सरल तरीका है।

वेबहुक कहाँ रह सकता है

आपके वेबहुक को एक सार्वजनिक HTTPS पता चाहिए जहाँ Gateway पहुँच सके। यह आपके अपने एप्लिकेशन का एंडपॉइंट, एक छोटा क्लाउड फ़ंक्शन, या n8n या Make जैसे ऑटोमेशन टूल में एक incoming webhook हो सकता है। आपके डिवाइस को खुद सार्वजनिक IP की ज़रूरत नहीं है। फ़ायरवॉल के पीछे की साइटें Hybrid Connector के ज़रिए Gateway से जुड़ सकती हैं, जो आउटबाउंड कनेक्शन पर काम करता है।

आपका सिस्टम तय करता है कि आगे क्या होगा

Gateway सत्यापित इवेंट भेजता है और आपकी पुष्टि का इंतज़ार करता है। उसके बाद क्या होता है, जैसे आपके HRMS में लिखना, डैशबोर्ड अपडेट करना, देर से आने की सूचना भेजना, या कोई वर्कफ़्लो शुरू करना, यह आपका अपना सॉफ़्टवेयर और नियम तय करते हैं।

05 · दोनों को एक साथ इस्तेमाल करना

पोलिंग अब भी कहाँ उपयोगी है

लाइव बायोमेट्रिक डेटा के लिए वेबहुक डिफ़ॉल्ट होने चाहिए। लेकिन अनुरोध पर डेटा लाने के भी कुछ उपयोगी, खास काम हैं। सबसे मज़बूत इंटीग्रेशन रियल-टाइम डिलीवरी के लिए वेबहुक और जाँच व रिकवरी के लिए कभी-कभार ऑन-डिमांड फ़ेच का इस्तेमाल करते हैं।

स्थिति सबसे अच्छा तरीका क्यों
लाइव अटेंडेंस, डैशबोर्ड, सूचनाएँ वेबहुक (Callback API) स्कैन होते ही डेटा पहुँच जाता है
आपका सर्वर कुछ समय के लिए ऑफ़लाइन था ऑन डिमांड लॉग फ़ेच करें किसी भी अंतर को भरें और पुष्टि करें कि कुछ छूटा नहीं
रात या साप्ताहिक मिलान (reconciliation) शेड्यूल पर लॉग फ़ेच करें सुरक्षा जाल के रूप में वेबहुक से मिले डेटा से तुलना करें
नए इंटीग्रेशन की सेटअप ऐतिहासिक लॉग एक बार फ़ेच करें वेबहुक शुरू होने से पहले मौजूदा इतिहास आयात करें
किसी विशेष अवधि का ऑडिट उस अवधि के लॉग फ़ेच करें समीक्षा के लिए पूरा रिकॉर्ड तैयार करें

इन कामों के लिए, Cams RESTful API में डिवाइस से लॉग लोड करने के ऑपरेशन शामिल हैं। कभी-कभी और सोच-समझकर उपयोग करने पर, लॉग फ़ेच करना वेबहुक से प्रतिस्पर्धा नहीं बल्कि उनका पूरक है। फ़र्क इरादे का है: आप तब फ़ेच करते हैं जब कोई कारण हो, न कि हर मिनट बस इस डर से कि कहीं कुछ छूट न जाए।

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

क्या बायोमेट्रिक डेटा के लिए पोलिंग कभी वेबहुक से बेहतर होती है?

जब आपका सिस्टम कोई सार्वजनिक एंडपॉइंट बिल्कुल उपलब्ध नहीं करा सकता, या एक बार के ऐतिहासिक आयात के लिए, तब पोलिंग सरल हो सकती है। लगातार चलने वाले अटेंडेंस और एक्सेस डेटा के लिए, वेबहुक तेज़, डिवाइस और नेटवर्क पर हल्के, और कई साइटों में आसानी से स्केल होने वाले होते हैं।

अगर मेरा वेबहुक सर्वर डाउन हो जाए तो स्कैन का क्या होगा?

यदि आपका वेबहुक सर्वर डाउन है, तो अटेंडेंस डेटा Cams queue में स्टोर होगा। आपका सर्वर वापस ऑनलाइन आने पर queue में रखे रिकॉर्ड अपने आप आपके सर्वर पर पुश कर दिए जाएँगे। Queue हर 3 घंटे में अपने आप रीस्टार्ट होती है, और आप Cams Portal से किसी भी समय उसे मैन्युअली भी रीस्टार्ट कर सकते हैं। इससे अस्थायी सर्वर डाउनटाइम के कारण अटेंडेंस रिकॉर्ड नहीं खोते।

क्या वेबहुक काम करने के लिए मेरे बायोमेट्रिक डिवाइस को सार्वजनिक IP चाहिए?

नहीं। आपके वेबहुक URL तक Gateway की पहुँच होनी चाहिए, लेकिन आपके डिवाइस तक नहीं। जिन साइटों के पास सार्वजनिक IP नहीं है, वे Hybrid Connector के ज़रिए जुड़ सकती हैं, जो आउटबाउंड कनेक्शन का उपयोग करता है।

क्या मैं n8n, Make या Zapier में वेबहुक प्राप्त कर सकता हूँ?

हाँ। कोई भी टूल जो incoming वेबहुक प्राप्त कर सकता है, वह Cams Callback इवेंट भी प्राप्त कर सकता है। n8n और Make आवश्यक done पुष्टि सीधे लौटा भी सकते हैं। Zapier को उस जवाब को भेजने के लिए उसके सामने एक छोटा रिले लगाना पड़ सकता है।

payload में LogTime और Time अलग क्यों हैं?

LogTime वह समय है जब व्यक्ति ने वास्तव में स्कैन किया, जो डिवाइस के टाइम ज़ोन ऑफ़सेट के साथ दर्ज होता है। Time संदेश का अपना टाइमस्टैम्प है, GMT में। अगर डिवाइस ऑफ़लाइन था, तो संदेश स्कैन के काफ़ी बाद भेजा जा सकता है। अटेंडेंस के लिए हमेशा LogTime का उपयोग करें।

निष्कर्ष: घंटी बजने दें

पोलिंग तब समझ में आती थी जब बायोमेट्रिक डिवाइस केवल अनुरोध पर पढ़े जा सकते थे, और किसी को उम्मीद नहीं थी कि अटेंडेंस डेटा लाइव होगा। आज HR डैशबोर्ड, पेरोल सिस्टम, ऑटोमेशन टूल और AI सहायक, सभी उस डेटा के साथ सबसे अच्छा काम करते हैं जो उसी पल उपलब्ध हो। किसी डिवाइस से एक ही सवाल दिन में हज़ारों बार पूछना वहाँ तक पहुँचने का धीमा और बर्बादी वाला तरीका है।

वेबहुक हर सत्यापित स्कैन को ऐसे इवेंट में बदल देते हैं जिसे आपके सिस्टम तुरंत प्राप्त करते हैं, बिना बेकार अनुरोधों और बिना पहले से लिए गए डेटा का नाज़ुक हिसाब रखे। ऑन-डिमांड लॉग फ़ेचिंग को उसके सबसे अच्छे काम के लिए रखें, यानी अंतर भरने और पूर्णता जाँचने के लिए, और बाकी सब वेबहुक को सँभालने दें।

Cams Biometrics Gateway पुश डिलीवरी के आधार पर बना है। इसका Callback API हर सत्यापित स्कैन को रियल टाइम में आपके वेबहुक पर भेजता है, 15 से अधिक ब्रांड के डिवाइस से, एक ही सुसंगत JSON फ़ॉर्मैट में। Hybrid Push मोड उन डिवाइस से भी पुश इवेंट देते हैं जो खुद पुश नहीं कर सकते, और RESTful API ऑन-डिमांड ऑपरेशन देता है, जैसे मिलान के लिए लॉग लोड करना। सारा संचार HTTP/HTTPS पर ऑथ टोकन सत्यापन और वैकल्पिक AES-256 एन्क्रिप्शन के साथ होता है। प्लेटफ़ॉर्म को CamsBiometrics.com पर देखें, और पूरा Callback API दस्तावेज़ developer.camsbiometrics.com पर पढ़ें।

Was this article helpful?