मुख्य सामग्री पर जाएं
हिन्दी

Purple Portal API: आप इसके साथ क्या कर सकते हैं

Purple Portal API का लाभ उठाने पर IT प्रबंधकों और नेटवर्क आर्किटेक्ट्स के लिए एक तकनीकी संदर्भ। यह गाइड बिजनेस इंटेलिजेंस और परिचालन दक्षता को बढ़ाने के लिए एंटरप्राइज़ सिस्टम के साथ गेस्ट WiFi डेटा को एकीकृत करने के लिए उपलब्ध एंडपॉइंट्स, प्रमाणीकरण और वास्तविक दुनिया के उपयोग के मामलों का विवरण देती है। इसमें हॉस्पिटैलिटी, रिटेल और इवेंट्स क्षेत्रों के ठोस केस स्टडीज़ के साथ REST API और Webhook एकीकरण पैटर्न दोनों शामिल हैं।

📖 9 मिनट का पाठ📝 2,212 शब्द🔧 2 हल किए गए उदाहरण❓ 3 अभ्यास प्रश्न📚 9 मुख्य परिभाषाएं

इस गाइड को सुनें

पॉडकास्ट ट्रांसक्रिप्ट देखें
Purple तकनीकी ब्रीफिंग में आपका स्वागत है। मैं Purple में एक सीनियर कंटेंट स्ट्रैटेजिस्ट हूँ, और अगले दस मिनट में, मैं आपको हमारे Portal API का एक संक्षिप्त, व्यावहारिक अवलोकन देने जा रहा हूँ — यह क्या है, आप इसके साथ क्या कर सकते हैं, और अधिकतम व्यावसायिक प्रभाव के लिए इसका लाभ कैसे उठा सकते हैं। यह उन IT प्रबंधकों, आर्किटेक्ट्स और संचालन निदेशकों के लिए है जिन्हें यह जानने की आवश्यकता है कि अपने गेस्ट WiFi को एक साधारण उपयोगिता से एक शक्तिशाली डेटा संपत्ति में कैसे बदला जाए। आइए संदर्भ से शुरू करते हैं। आपके स्थानों पर गेस्ट WiFi है। हर दिन, सैकड़ों या हजारों लोग जुड़ते हैं। वे अपना ईमेल, शायद अपना नाम प्रदान करते हैं, और वे आपकी शर्तों पर सहमति देते हैं। वह मूल्यवान फर्स्ट-पार्टी डेटा है। Purple पोर्टल आपको इसे देखने के लिए शानदार डैशबोर्ड देता है, लेकिन असली शक्ति तब आती है जब आप उस डेटा को अपने बाकी व्यावसायिक पारिस्थितिकी तंत्र (ecosystem) से जोड़ते हैं। यहीं पर Portal API काम आता है। यह वह पुल है जो आपके सिस्टम को हमारे प्लेटफ़ॉर्म से प्रोग्रामेटिक रूप से बात करने की अनुमति देता है। अब, तकनीकी विवरण में आते हैं। Portal API एक मानक RESTful इंटरफ़ेस है। प्रमाणीकरण एक सीधी API Key का उपयोग करके सरल और सुरक्षित है। आपको सर्वर-टू-सर्वर संचार के लिए जटिल OAuth हैंडशेक के बारे में चिंता करने की आवश्यकता नहीं है। गंभीर रूप से, कोई रेट लिमिट नहीं है। हमने इसे एंटरप्राइज़ स्केल के लिए बनाया है, इसलिए चाहे आप एक होटल चला रहे हों या पांच सौ रिटेल स्थानों की राष्ट्रीय चेन, API आपके वॉल्यूम को संभाल सकता है। आपके पास डेटा निकालने के दो मुख्य तरीके हैं। पहला, पुल विधि: मानक REST एंडपॉइंट्स। विज़िटर्स और वेन्यू जैसे एंडपॉइंट्स के बारे में सोचें। आप एक शेड्यूल पर इन एंडपॉइंट्स को कॉल करने के लिए एक स्क्रिप्ट लिख सकते हैं, पिछले चौबीस घंटों के सभी विज़िटर डेटा को नीचे खींच सकते हैं, और विश्लेषण के लिए इसे अपने डेटा वेयरहाउस में लोड कर सकते हैं। यह बिजनेस इंटेलिजेंस के लिए, Power BI या Tableau में उन बड़े-चित्र वाले डैशबोर्ड बनाने के लिए आपका गो-टू है। लेकिन वास्तव में रोमांचक हिस्सा पुश विधि है: Webhooks। यह रीयल-टाइम के लिए है। आप अपनी तरफ एक लिस्नर एंडपॉइंट सेट करते हैं, और जिस क्षण कोई गेस्ट आपके WiFi पर प्रमाणित होता है, हम आपको उनके सभी विवरणों के साथ एक JSON पेलोड भेजते हैं — नाम, ईमेल, वे किस वेन्यू में हैं, उनका विज़िट काउंट, और यहां तक कि उनके द्वारा उपयोग की जाने वाली प्रमाणीकरण विधि, चाहे वह पंजीकरण फॉर्म हो, सोशल लॉगिन हो, या कुछ और। यह लगभग तुरंत है। यह वह है जो तत्काल, व्यक्तिगत जुड़ाव को अनलॉक करता है। यह कल एक मार्केटिंग ईमेल भेजने, और एक वफादार ग्राहक के आपके दरवाजे से अंदर आते ही एक अद्वितीय प्रस्ताव के साथ एक वेलकम बैक अधिसूचना भेजने के बीच का अंतर है। मुझे आपको मिलने वाले डेटा फ़ील्ड्स के बारे में बात करने दें। Webhook पेलोड चार मुख्य ऑब्जेक्ट्स में संरचित है। क्लाइंट ऑब्जेक्ट आपको MAC एड्रेस और यूज़र एजेंट देता है। कंपनी और वेन्यू ऑब्जेक्ट आपको विशिष्ट स्थान के पहचानकर्ता और जियो-कोऑर्डिनेट्स देते हैं। सेशन ऑब्जेक्ट आपको प्रमाणीकरण टाइमस्टैम्प देता है। और यूज़र ऑब्जेक्ट वह जगह है जहाँ सोना है: प्रथम नाम, अंतिम नाम, ईमेल, लिंग, जन्म तिथि, मोबाइल नंबर, पोस्टकोड, और प्रति वेन्यू एक विज़िट काउंट जो पहली और आखिरी विज़िट की तारीखें दिखाता है। आप अपने स्प्लैश पेज पंजीकरण फॉर्म से कस्टम फ़ील्ड भी कैप्चर कर सकते हैं, इसलिए यदि आप मेहमानों से उनका लॉयल्टी प्रोग्राम नंबर या होटल में उनका कमरा नंबर पूछते हैं, तो वह भी आता है। अब, API के संस्करण एक बिंदु सात (v1.7) में, ध्यान देने योग्य एक महत्वपूर्ण सुधार है। अनसब्सक्राइब फ़ील्ड अब उन उपयोगकर्ताओं के बीच स्पष्ट रूप से अंतर करता है जिन्होंने पहले सब्सक्राइब होने के बाद सक्रिय रूप से मार्केटिंग से ऑप्ट आउट किया था, बनाम वे जिन्होंने कभी ऑप्ट इन ही नहीं किया था। यह GDPR अनुपालन और सटीक सेगमेंटेशन के लिए महत्वपूर्ण है। आप एक लैप्स्ड सब्सक्राइबर के साथ उस व्यक्ति के समान व्यवहार नहीं करना चाहते जो कभी आपके मार्केटिंग फ़नल में था ही नहीं। आइए एकीकरण पैटर्न के बारे में अधिक विस्तार से बात करते हैं। REST API पुल पैटर्न के लिए, आपका विशिष्ट वर्कफ़्लो एक शेड्यूल्ड स्क्रिप्ट है, शायद Python या Node.js में, जो रात में चलती है। यह आपकी API Key के साथ प्रमाणित होती है, प्रत्येक वेन्यू के लिए विज़िटर्स एंडपॉइंट को क्वेरी करती है, डेटा को आपके आवश्यक फॉर्मेट में बदलती है, और इसे एक केंद्रीय डेटाबेस में लोड करती है। यह एक क्लासिक ETL प्रक्रिया है। एक मल्टी-साइट ऑपरेटर के लिए, आप अपने वेन्यू ID के माध्यम से पुनरावृति करेंगे और डेटा को केंद्रीय रूप से एकत्रित करेंगे। Webhook पुश पैटर्न के लिए, आर्किटेक्चर थोड़ा अलग है। आपको एक सार्वजनिक रूप से सुलभ, SSL-सुरक्षित एंडपॉइंट की आवश्यकता है। एक सर्वरलेस फ़ंक्शन यहाँ आदर्श है — AWS Lambda, Azure Functions, या Google Cloud Functions। यह लागत-प्रभावी है, स्वचालित रूप से स्केल होता है, और उस समवर्तीता (concurrency) को संभालता है जो आप एक व्यस्त वेन्यू में देखेंगे। जब फ़ंक्शन Purple से POST रिक्वेस्ट प्राप्त करता है, तो उसे JSON को पार्स करना चाहिए, अपना व्यावसायिक लॉजिक निष्पादित करना चाहिए — शायद CRM लुकअप या लॉयल्टी चेक — और जितनी जल्दी हो सके दो सौ (200) OK रिस्पॉन्स लौटाना चाहिए। यह मुझे सबसे महत्वपूर्ण कार्यान्वयन आवश्यकता पर लाता है: आपके लिस्नर को दस सेकंड के भीतर प्रतिक्रिया देनी चाहिए। यदि यह ऐसा नहीं करता है, तो Purple रिक्वेस्ट को फिर से कतारबद्ध करेगा और तीन घंटे के बाद पुनः प्रयास करेगा। लगातार विफलताओं के कारण सुरक्षा कारणों से Webhook स्वचालित रूप से अक्षम हो जाएगा। इसलिए अपने लिस्नर को हल्का रखें। तेज़ रिस्पॉन्स लौटाने के लिए आवश्यक न्यूनतम प्रोसेसिंग करें, और यदि आपको भारी प्रोसेसिंग करने की आवश्यकता है, तो इवेंट को एक आंतरिक कतार में धकेलें और इसे एसिंक्रोनस रूप से संसाधित करें। अब इसे ठोस बनाने के लिए कुछ वास्तविक दुनिया के परिदृश्यों को देखते हैं। एक दो-सौ-कमरों वाले होटल पर विचार करें। वे नए WiFi मेहमानों को अपने मार्केटिंग प्लेटफ़ॉर्म में एक स्वागत ईमेल यात्रा में स्वचालित रूप से नामांकित करना चाहते हैं। समाधान सीधा है: एक Webhook कॉन्फ़िगर करें, एक सरल सर्वरलेस लिस्नर बनाएं, और जब किसी नए उपयोगकर्ता का डेटा आता है, तो जांचें कि क्या वे पहले से ही मार्केटिंग प्लेटफ़ॉर्म में मौजूद हैं। यदि नहीं, तो उन्हें जोड़ें और स्वागत यात्रा को ट्रिगर करें। होटल पहली बार आने वाले विज़िटर्स को लौटने वाले मेहमानों से अलग करने और तदनुसार संचार को तैयार करने के लिए विज़िट काउंट फ़ील्ड का भी उपयोग कर सकता है। लौटने वाले गेस्ट को सामान्य स्वागत के बजाय लॉयल्टी इनाम प्रस्ताव प्राप्त हो सकता है। अब पचास स्टोर वाली एक राष्ट्रीय रिटेल चेन पर विचार करें। वे सभी स्थानों पर पैदल यातायात के रुझान दिखाने वाला एक केंद्रीय डैशबोर्ड चाहते हैं। यहाँ, REST API पुल पैटर्न सही विकल्प है। एक रात्रिकालीन स्क्रिप्ट पचास वेन्यू में से प्रत्येक के लिए विज़िटर्स एंडपॉइंट को क्वेरी करती है, डेटा को एकत्रित करती है, और इसे डेटा वेयरहाउस में लोड करती है। एनालिटिक्स टीम फिर इसके शीर्ष पर अपने डैशबोर्ड बनाती है। वे देख सकते हैं कि किन स्टोर्स में नए विज़िटर की दर सबसे अधिक है, किन में लौटने वाले विज़िटर का अनुपात सबसे अच्छा है, और ड्वेल टाइम बिक्री प्रदर्शन के साथ कैसे सहसंबंधित (correlate) होता है। अब मैं कुछ सामान्य नुकसानों (pitfalls) और उनसे बचने के तरीकों को कवर करता हूँ। पहला नुकसान डुप्लिकेट इवेंट हैंडलिंग है। एक एकल गेस्ट विज़िट कई प्रमाणीकरण घटनाओं को ट्रिगर कर सकती है — उदाहरण के लिए, यदि वे अपने फोन की स्क्रीन को लॉक होने देते हैं और यह फिर से कनेक्ट होता है, या यदि वे एक्सेस पॉइंट के बीच रोम करते हैं। आपका लिस्नर इडेम्पोटेंट होना चाहिए। ईमेल भेजने जैसी कार्रवाई करने से पहले, जांचें कि क्या आपने आज उस उपयोगकर्ता के लिए पहले ही किसी घटना को संसाधित कर लिया है। दूसरा नुकसान लाइव होने से पहले अपने लिस्नर URL को मान्य न करना है। Purple को डेटा प्राप्त करने से पहले आपको पोर्टल में एंडपॉइंट को मान्य करने की आवश्यकता होती है। सुनिश्चित करें कि आपका लिस्नर लाइव है और इसे LogicFlow से जोड़ने से पहले सही wifiWebhookListener हेडर लौटा रहा है। तीसरा नुकसान सदस्यता स्थिति को अनदेखा करना है। किसी उपयोगकर्ता को मार्केटिंग सूची में जोड़ने से पहले हमेशा अनसब्सक्राइब फ़ील्ड की जांच करें। ऑप्ट आउट कर चुके किसी व्यक्ति को मार्केटिंग संचार भेजना एक GDPR उल्लंघन है जिसके महत्वपूर्ण परिणाम हो सकते हैं। अब एक रैपिड-फायर प्रश्न और उत्तर सत्र के लिए। क्या मैं इसे अपने कस्टम-निर्मित CRM के साथ सिंक कर सकता हूँ? हाँ। यदि आपके CRM में API है, तो आप Purple डेटा को फॉर्मेट करने और इसे अपने सिस्टम में पुश करने के लिए मिडलवेयर के रूप में Webhook लिस्नर का उपयोग कर सकते हैं। Webhook पेलोड में लौटाए गए ID REST API में मौजूद ID से मेल खाते हैं, इसलिए यदि आवश्यक हो तो आप अतिरिक्त विवरण प्राप्त करने के लिए फॉलो-अप कॉल भी कर सकते हैं। मैं उस उपयोगकर्ता को कैसे संभालूं जो मेरे एस्टेट में कई साइटों पर जाता है? API प्रति वेन्यू ID विज़िट काउंट प्रदान करता है, ताकि आप आसानी से अपने पूरे एस्टेट में ग्राहक की यात्रा को ट्रैक कर सकें और एक व्यापक क्रॉस-साइट प्रोफ़ाइल बना सकें। क्या मैं कितने Webhook URL कॉन्फ़िगर कर सकता हूँ, इसकी कोई सीमा है? नहीं। आप जितने चाहें उतने लिस्नर URL को मान्य और उपयोग कर सकते हैं, जो तब उपयोगी होता है जब विभिन्न टीमों या सिस्टम को समान इवेंट डेटा प्राप्त करने की आवश्यकता होती है। यदि मेरा लिस्नर रखरखाव के लिए डाउन हो जाता है तो क्या होगा? Purple विफल डिलीवरी का पुनः प्रयास करेगा, इसलिए जब आपका लिस्नर वापस ऑनलाइन आएगा तो आपको घटनाओं का बैकलॉग प्राप्त हो सकता है। आपके लिस्नर को इसे शालीनता से संभालने की आवश्यकता है, उन घटनाओं को संसाधित करना जो कालानुक्रमिक क्रम से बाहर आ सकती हैं। आज हमने जो कुछ भी कवर किया है उसे संक्षेप में प्रस्तुत करने के लिए, Purple Portal API आपके गेस्ट WiFi डेटा के भीतर अपार मूल्य को अनलॉक करने की आपकी कुंजी है। रिपोर्टिंग और एनालिटिक्स के लिए डेटा खींचने के लिए REST API का उपयोग करें। तत्काल, व्यक्तिगत ग्राहक जुड़ाव के लिए रीयल-टाइम में डेटा पुश करने के लिए Webhooks का उपयोग करें। मुख्य सिद्धांत याद रखें: रीयल-टाइम के लिए पुश, रिपोर्ट्स के लिए पुल। आपका अगला कदम हमारे सपोर्ट पोर्टल में API दस्तावेज़ों की समीक्षा करना है। यदि आपके पास Engage लाइसेंस है, तो एक API Key जनरेट करें और Postman के साथ एक्सप्लोर करना शुरू करें। एक सरल Webhook लिस्नर बनाएं। डेटा को प्रवाहित होते हुए देखें। वह क्षण है जब इस टूल की क्षमता बिल्कुल स्पष्ट हो जाती है। Purple तकनीकी ब्रीफिंग सुनने के लिए धन्यवाद। यदि आप अपनी विशिष्ट एकीकरण आवश्यकताओं के बारे में हमारे किसी समाधान आर्किटेक्ट से बात करना चाहते हैं, तो purple dot ai पर जाएं और एक डेमो बुक करें। अगली बार तक के लिए, विदा।

header_image.png

कार्यकारी सारांश

मल्टी-साइट स्थानों — होटल, रिटेल चेन, स्टेडियम और सम्मेलन केंद्रों — के IT लीडर्स के लिए, गेस्ट WiFi नेटवर्क एक साधारण सुविधा से कहीं अधिक है। यह फर्स्ट-पार्टी डेटा का एक समृद्ध, निरंतर प्राप्त होने वाला स्रोत है जो मार्केटिंग, संचालन और ग्राहक अनुभव में मापने योग्य व्यावसायिक प्रभाव ला सकता है। Purple Portal API इस मूल्य को बड़े पैमाने पर अनलॉक करने के लिए आवश्यक प्रोग्रामेटिक इंटरफ़ेस प्रदान करता है। यह तकनीकी टीमों को अंतर्निहित एनालिटिक्स डैशबोर्ड से आगे बढ़ने और मजबूत, स्वचालित एकीकरण (integrations) बनाने की अनुमति देता है जो GDPR-अनुपालक विज़िटर डेटा को सीधे कोर बिजनेस सिस्टम में फीड करते हैं, CRM प्लेटफॉर्म और मार्केटिंग ऑटोमेशन टूल से लेकर लॉयल्टी प्रोग्राम और बिजनेस इंटेलिजेंस वेयरहाउस तक।

यह गाइड समाधान आर्किटेक्ट्स, IT प्रबंधकों और वरिष्ठ डेवलपर्स के लिए एक व्यावहारिक, कार्रवाई योग्य संदर्भ है। यह प्रमाणीकरण (authentication) मॉडल, उपलब्ध एंडपॉइंट्स, एकीकरण पैटर्न और वास्तविक दुनिया के परिनियोजन (deployment) परिदृश्यों का विवरण देता है जो प्रदर्शित करते हैं कि Purple WiFi API कैसे एक WiFi परिनियोजन को लागत केंद्र से रणनीतिक डेटा संपत्ति में बदल सकता है। चाहे आप पहली बार API का मूल्यांकन कर रहे हों या उत्पादन-ग्रेड एकीकरण की योजना बना रहे हों, यह दस्तावेज़ आपको आत्मविश्वास के साथ आगे बढ़ने के लिए आवश्यक तकनीकी आधार और निर्णय ढांचे प्रदान करता है。

तकनीकी डीप-डाइव

प्रमाणीकरण और API वर्ज़निंग

Purple Portal API API Key प्रमाणीकरण का उपयोग करता है, जो सर्वर-टू-सर्वर एकीकरण के लिए उपयुक्त एक सीधा और सुरक्षित मॉडल है। OAuth 2.0 फ्लो के विपरीत, जिसके लिए टोकन एक्सचेंज और रिफ्रेश साइकिल की आवश्यकता होती है, API Key प्रमाणीकरण में रिक्वेस्ट हेडर में एक स्टैटिक सीक्रेट शामिल करना होता है। यह सरलता सुरक्षा से समझौता किए बिना एकीकरण ओवरहेड को कम करती है, बशर्ते कुंजी को सुरक्षित रूप से संग्रहीत किया जाए और आपकी मानक क्रेडेंशियल प्रबंधन नीति के हिस्से के रूप में समय-समय पर रोटेट किया जाए।

वर्तमान उत्पादन संस्करण v1.7 है, जिसने v1.6.2 की तुलना में कई महत्वपूर्ण सुधार पेश किए हैं। सबसे महत्वपूर्ण बात यह है कि, उपयोगकर्ता डेटा ऑब्जेक्ट में unsubscribed प्रॉपर्टी अब स्पष्ट रूप से उस उपयोगकर्ता के बीच अंतर करती है जिसने पहले सब्सक्राइब होने के बाद सक्रिय रूप से मार्केटिंग से ऑप्ट आउट किया था, और उस उपयोगकर्ता के बीच जिसने कभी सब्सक्राइब ही नहीं किया था। यह अंतर GDPR अनुपालन और सटीक ऑडियंस सेगमेंटेशन के लिए महत्वपूर्ण है। इसके अतिरिक्त, Visitors और Venues एंडपॉइंट अब डेटा न मिलने पर 404 Not Found के बजाय HTTP 200 OK रिस्पॉन्स लौटाते हैं, जिससे पहले मॉनिटरिंग और एरर-हैंडलिंग लॉजिक में भ्रम पैदा होता था।

उपलब्ध एंडपॉइंट्स

पोर्टल कंपनी API तीन प्राथमिक एंडपॉइंट श्रेणियों को उजागर करता है जिनके साथ IT टीमें नियमित रूप से इंटरैक्ट करेंगी।

एंडपॉइंट मेथड उद्देश्य
/visitors GET संपर्क डेटा, जनसांख्यिकी और विज़िट इतिहास सहित गेस्ट विज़िटर प्रोफ़ाइल प्राप्त करें
/venues GET वेन्यू-स्तर का डेटा और कॉन्फ़िगरेशन मेटाडेटा प्राप्त करें
/unsubscribes GET उन उपयोगकर्ताओं की सूची प्राप्त करें जिन्होंने मार्केटिंग संचार से ऑप्ट आउट किया है

सभी एंडपॉइंट JSON फॉर्मेट में डेटा लौटाते हैं। visitors एंडपॉइंट का सबसे अधिक उपयोग किया जाता है, क्योंकि यह Captive Portal प्रमाणीकरण यात्रा के दौरान एकत्र किए गए गेस्ट प्रोफ़ाइल डेटा की पूर्ण समृद्धि को उजागर करता है। इसमें प्रथम नाम, अंतिम नाम, ईमेल पता, लिंग, जन्म तिथि, मोबाइल नंबर, पोस्टकोड, प्रमाणीकरण प्रदाता (जैसे, पंजीकरण फॉर्म, सोशल लॉगिन), प्रति वेन्यू विज़िट की संख्या, और स्प्लैश पेज पर कॉन्फ़िगर किए गए कोई भी कस्टम फ़ील्ड शामिल हैं।

रेट लिमिट्स

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

एकीकरण पैटर्न: पुल बनाम पुश

Purple WiFi API दो मौलिक रूप से भिन्न एकीकरण पैटर्न का समर्थन करता है, प्रत्येक अलग-अलग उपयोग के मामलों के अनुकूल है। किसी दिए गए परिदृश्य में किस पैटर्न को लागू करना है, यह समझना आपके द्वारा लिया जाने वाला सबसे महत्वपूर्ण आर्किटेक्चरल निर्णय है।

REST API पुल पैटर्न में आपका सिस्टम डेटा प्राप्त करने के लिए API एंडपॉइंट्स पर ऑन-डिमांड या शेड्यूल्ड रिक्वेस्ट करता है। यह बैच प्रोसेसिंग, रिपोर्टिंग और बिजनेस इंटेलिजेंस के लिए सही दृष्टिकोण है। एक रात्रिकालीन ETL स्क्रिप्ट जो पिछले दिन के सभी विज़िटर डेटा को खींचती है और इसे डेटा वेयरहाउस में लोड करती है, इसका एक प्रामाणिक उदाहरण है। पुल पैटर्न आपको इस बात पर पूर्ण नियंत्रण देता है कि आप कब और कितना डेटा प्राप्त करते हैं।

Webhook पुश पैटर्न में Purple आपके सिस्टम को उस क्षण डेटा भेजता है जब कोई विशिष्ट घटना घटित होती है — विशेष रूप से, जब कोई गेस्ट WiFi नेटवर्क पर प्रमाणित होता है। आपके सिस्टम को एक सार्वजनिक रूप से सुलभ, SSL-सुरक्षित HTTP एंडपॉइंट (एक 'लिस्नर') को उजागर करना चाहिए जो इन JSON POST पेलोड को प्राप्त और संसाधित कर सके। Webhook पैटर्न किसी भी उपयोग के मामले के लिए सही विकल्प है जिसमें नियर-रियल-टाइम डेटा की आवश्यकता होती है, जैसे कि व्यक्तिगत स्वागत संदेश ट्रिगर करना, CRM में ग्राहक की 'लास्ट सीन' स्थिति को अपडेट करना, या हॉस्पिटैलिटी मैनेजर को सूचित करना कि कोई VIP गेस्ट आ गया है।

api_architecture_diagram.png

Webhook पेलोड संरचना

Purple Webhook द्वारा डिलीवर किया गया JSON पेलोड चार मुख्य ऑब्जेक्ट्स में संरचित होता है, जिनमें से प्रत्येक प्रमाणीकरण घटना के लिए संदर्भ का एक अलग आयाम प्रदान करता है।

ऑब्जेक्ट प्रमुख फ़ील्ड विवरण
client mac, userAgent डिवाइस-स्तर के पहचानकर्ता
company id, name, uniqId आपकी कंपनी के खाते का विवरण
venue id, name, latitude, longitude वह विशिष्ट स्थान जहाँ प्रमाणीकरण हुआ
session authenticationTime प्रमाणीकरण घटना का ISO 8601 टाइमस्टैम्प
user email, firstName, lastName, gender, provider, visitCountForVenues, customFields पूर्ण गेस्ट प्रोफ़ाइल डेटा

user.visitCountForVenues ऑब्जेक्ट मल्टी-साइट ऑपरेटरों के लिए विशेष रूप से मूल्यवान है। यह firstVisit और lastVisit टाइमस्टैम्प के साथ प्रति-वेन्यू विज़िट काउंट प्रदान करता है, जिससे आप प्रमाणीकरण के बिंदु पर पहली बार आने वाले विज़िटर्स बनाम वफादार लौटने वाले ग्राहकों की पहचान कर सकते हैं — बिना किसी अतिरिक्त API कॉल के।

कार्यान्वयन गाइड

पूर्वापेक्षाएँ और सेटअप

पोर्टल API तक पहुँचने के लिए Engage लाइसेंस की आवश्यकता होती है। लाइसेंस प्राप्त होने के बाद, Purple पोर्टल की सेटिंग्स के भीतर से अपनी API Key जनरेट करें। प्रारंभिक विकास और परीक्षण के लिए, Postman अनुशंसित टूल है; Purple सही पर्यावरण चर (environment variables) और रिक्वेस्ट हेडर को कॉन्फ़िगर करने के लिए एक समर्पित सेटअप गाइड प्रदान करता है। सर्वर-साइड स्क्रिप्टिंग शुरुआती बिंदु को प्राथमिकता देने वाली टीमों के लिए एक PHP डेमो फ़ाइल भी उपलब्ध है।

Webhook एकीकरण को कॉन्फ़िगर करना

Webhook एकीकरण को तैनात करने में पाँच चरण शामिल हैं। पहला, अपने लिस्नर एंडपॉइंट को सार्वजनिक रूप से सुलभ, SSL-सुरक्षित URL पर बनाएँ और तैनात करें। एक सर्वरलेस फ़ंक्शन (AWS Lambda, Azure Functions, या Google Cloud Functions) एक वास्तुशिल्प रूप से सुदृढ़ विकल्प है: यह स्वचालित रूप से स्केल होता है, कम वॉल्यूम पर न्यूनतम लागत लगाता है, और बिना कॉन्फ़िगरेशन के समवर्ती रिक्वेस्ट को संभालता है। दूसरा, Management > Venues > Webhooks पर नेविगेट करके Purple पोर्टल में लिस्नर URL को मान्य करें। Purple यह पुष्टि करने के लिए एक परीक्षण रिक्वेस्ट भेजेगा कि एंडपॉइंट पहुँच योग्य है और आवश्यक wifiWebhookListener: 1 हेडर लौटाता है। तीसरा, पोर्टल में एक LogicFlow बनाएँ या संपादित करें और अपना मान्य URL चुनते हुए एक Webhook Action Node जोड़ें। चौथा, सुनिश्चित करें कि LogicFlow 'Online' स्थिति पर सेट है। पाँचवाँ, LogicFlow को प्रासंगिक Access Journey से जोड़ें। इस बिंदु से, उस यात्रा पर प्रत्येक गेस्ट प्रमाणीकरण आपके Webhook को ट्रिगर करेगा।

रिट्राइज़ और इडेम्पोटेंसी (Idempotency) को संभालना

आपके लिस्नर को वितरित प्रणालियों (distributed systems) की वास्तविकताओं को संभालने के लिए डिज़ाइन किया जाना चाहिए। यदि आपका लिस्नर अनुत्तरदायी है (टाइमआउट 10 सेकंड से अधिक है) या कोई त्रुटि स्थिति लौटाता है, तो Purple तीन घंटे के बाद विफल Webhook डिलीवरी का पुनः प्रयास करेगा। इसका मतलब है कि आपके लिस्नर को एक ही घटना कई बार प्राप्त हो सकती है। इसके अलावा, एक एकल गेस्ट विज़िट कई प्रमाणीकरण घटनाओं को ट्रिगर कर सकती है — उदाहरण के लिए, जब स्क्रीन लॉक होने के बाद कोई डिवाइस फिर से कनेक्ट होता है, या जब कोई उपयोगकर्ता एक्सेस पॉइंट के बीच रोम करता है। इसलिए आपका प्रोसेसिंग लॉजिक इडेम्पोटेंट (idempotent) होना चाहिए: एक ही घटना को दो बार लागू करने से वही परिणाम मिलना चाहिए जो इसे एक बार लागू करने पर मिलता है। एक सामान्य कार्यान्वयन पैटर्न यह जाँचना है कि क्या किसी दिए गए उपयोगकर्ता ID के लिए एक परिभाषित समय विंडो के भीतर कोई कार्रवाई (जैसे स्वागत ईमेल भेजना) पहले ही की जा चुकी है, इसे निष्पादित करने से पहले।

सर्वोत्तम प्रथाएँ

Purple Portal API के किसी भी उत्पादन परिनियोजन को कई सिद्धांतों द्वारा निर्देशित किया जाना चाहिए। हमेशा नवीनतम API संस्करण (v1.7) के विरुद्ध तैनात करें और नए संस्करण जारी होने पर अपने URL पथ और रिस्पॉन्स पार्सिंग लॉजिक को अपडेट करें। अपनी API Key को एक संवेदनशील क्रेडेंशियल के रूप में मानें: इसे साझा सिस्टम पर स्रोत कोड या पर्यावरण चर के बजाय एक सीक्रेट्स मैनेजर (जैसे AWS Secrets Manager या Azure Key Vault) में संग्रहीत करें। Webhook लिस्नर्स के लिए, डिबगिंग और ऑडिट ट्रेल्स को सुविधाजनक बनाने के लिए प्रत्येक आने वाले पेलोड और रिस्पॉन्स की संरचित लॉगिंग लागू करें। उपयोगकर्ता ऑब्जेक्ट में unsubscribed और unsubscribedDate फ़ील्ड का सम्मान करें; ऑप्ट-आउट किए गए उपयोगकर्ताओं के खिलाफ मार्केटिंग कार्रवाई संसाधित करना GDPR उल्लंघन का गठन करता है। अंत में, एज केसेस की पूरी श्रृंखला के खिलाफ अपने एकीकरण का परीक्षण करें: बिना ईमेल पते वाले उपयोगकर्ता, कस्टम फ़ील्ड वाले उपयोगकर्ता जो शून्य (null) हैं, और प्रमाणीकरण घटनाएँ जो कालानुक्रमिक क्रम से बाहर आती हैं।

webhook_integration_infographic.png

समस्या निवारण और जोखिम न्यूनीकरण

Webhook एकीकरण में सबसे आम विफलता मोड एक धीमा या अनुपलब्ध लिस्नर है। यदि एंडपॉइंट लगातार 10 सेकंड के भीतर प्रतिक्रिया देने में विफल रहता है, तो Purple लंबे समय तक अनुत्तरदायी रहने के बाद स्वचालित रूप से Webhook को अक्षम कर देगा, जिसके लिए पोर्टल में मैन्युअल पुन: सत्यापन की आवश्यकता होगी। इस जोखिम को कम करने के लिए, अपने लिस्नर के समान सर्वर पर एक हेल्थ चेक एंडपॉइंट लागू करें और इसे अपनी बुनियादी ढांचा निगरानी में शामिल करें। सुनिश्चित करें कि आपका लिस्नर 200 OK रिस्पॉन्स लौटाने से पहले केवल न्यूनतम सिंक्रोनस प्रोसेसिंग करता है; किसी भी भारी गणना या डाउनस्ट्रीम API कॉल को एसिंक्रोनस कतार में ऑफलोड करें。

REST API एकीकरण के लिए, यदि शेड्यूल्ड पुल जॉब चुपचाप विफल हो जाता है, तो डाउनस्ट्रीम सिस्टम में डेटा बासीपन (staleness) प्राथमिक जोखिम है। यदि कोई रन विफल हो जाता है या अप्रत्याशित रूप से कोई आउटपुट नहीं देता है, तो संचालन टीम को सूचित करने के लिए अपनी ETL स्क्रिप्ट पर अलर्टिंग लागू करें। API v1.6.2 से v1.7 में माइग्रेट करते समय, उस सभी कोड का ऑडिट करें जो unsubscribed फ़ील्ड और Unsubscribes एंडपॉइंट को संदर्भित करता है, क्योंकि v1.7 में प्रॉपर्टी का नाम unsubcribers से सुधार कर unsubscribers कर दिया गया था।

ROI और व्यावसायिक प्रभाव

Purple Portal API के साथ एकीकरण के लिए व्यावसायिक मामला कई वर्टिकल्स में अच्छी तरह से स्थापित है। हॉस्पिटैलिटी में, Webhook-ट्रिगर CRM एकीकरण का उपयोग करने वाले होटल सामान्य ब्रॉडकास्ट अभियानों की तुलना में व्यक्तिगत संचार के लिए ईमेल ओपन रेट्स में महत्वपूर्ण सुधार की रिपोर्ट करते हैं, क्योंकि संदेश अधिकतम प्रासंगिकता के क्षण में दिया जाता है — जब गेस्ट भौतिक रूप से साइट पर होता है। रिटेल में, गेस्ट WiFi डेटा को लॉयल्टी प्रोग्राम से जोड़ने से ऑपरेटरों को उच्च-आवृत्ति वाले विज़िटर्स की पहचान करने और उन्हें पुरस्कृत करने में मदद मिलती है, जिससे औसत खर्च और बार-बार आने की दर बढ़ जाती है। बड़े सार्वजनिक स्थानों और सम्मेलन केंद्रों के लिए, API-संचालित एनालिटिक्स प्रायोजन मूल्यांकन (sponsorship valuations) को सही ठहराने और रियायत प्लेसमेंट (concession placement) को अनुकूलित करने के लिए आवश्यक विस्तृत फुटफॉल डेटा प्रदान करते हैं।

Purple WiFi API पर रेट लिमिट्स की अनुपस्थिति का मतलब है कि एकीकरण की लागत आपके बुनियादी ढांचे के साथ स्केल होती है, न कि आपके द्वारा संसाधित किए जाने वाले डेटा की मात्रा के साथ। प्रतिदिन सैकड़ों हजारों प्रमाणीकरणों को संसाधित करने वाली एक राष्ट्रीय रिटेल चेन के लिए, यह उन प्लेटफ़ॉर्म्स पर एक भौतिक लाभ है जो प्रति API कॉल शुल्क लेते हैं या थ्रूपुट कैप लगाते हैं। इसलिए एक अच्छी तरह से आर्किटेक्ट किए गए Purple API एकीकरण के लिए स्वामित्व की कुल लागत (Total Cost of Ownership) मुख्य रूप से एकमुश्त विकास लागत और लिस्नर की चल रही बुनियादी ढांचा लागत है, जो दोनों आम तौर पर केवल बेहतर मार्केटिंग रूपांतरण दरों के माध्यम से पहली तिमाही के भीतर वसूल कर ली जाती हैं।

retail_integration_usecase.png

केस स्टडीज़

केस स्टडी 1: हॉस्पिटैलिटी — Whitbread Group

यूके की सबसे बड़ी होटल और रेस्तरां कंपनी, Whitbread, अपने Premier Inn और रेस्तरां एस्टेट में हजारों गेस्ट WiFi एक्सेस पॉइंट संचालित करती है। Purple Portal API को अपने CRM प्लेटफ़ॉर्म के साथ एकीकृत करके, समूह एक एकीकृत गेस्ट प्रोफ़ाइल बनाने में सक्षम था जो ऑनलाइन बुकिंग डेटा को WiFi Captive Portal पर कैप्चर किए गए भौतिक विज़िट व्यवहार के साथ जोड़ता है। Webhook एकीकरण हर गेस्ट प्रमाणीकरण पर फायर होता है, जो नवीनतम विज़िट टाइमस्टैम्प, वेन्यू स्थान और डिवाइस जानकारी के साथ CRM रिकॉर्ड को समृद्ध करता है। यह मार्केटिंग टीम को नवीनता (recency), आवृत्ति और स्थान के आधार पर ऑडियंस को सेगमेंट करने और अत्यधिक व्यक्तिगत री-एंगेजमेंट अभियानों को ट्रिगर करने में सक्षम बनाता है। प्रमुख तकनीकी परिणाम किसी गेस्ट के आगमन और सक्रिय मार्केटिंग यात्रा में उनके प्रवेश के बीच के समय में 24 घंटे (पिछले बैच-पोलिंग मॉडल के तहत) से 60 सेकंड से कम की कमी थी।

केस स्टडी 2: रिटेल — मल्टी-साइट फैशन रिटेलर

80 से अधिक स्टोर वाले एक राष्ट्रीय फैशन रिटेलर ने अपनी ग्राहक डेटा रणनीति में एक महत्वपूर्ण अंतर को दूर करने के लिए Purple Portal API तैनात किया: उनके पास मजबूत ई-कॉमर्स डेटा था लेकिन इन-स्टोर विज़िटर व्यवहार के बारे में वस्तुतः कोई जानकारी नहीं थी। रात्रिकालीन ETL प्रक्रिया के माध्यम से Purple गेस्ट WiFi API को अपने मौजूदा डेटा वेयरहाउस से जोड़कर, उन्होंने पहली बार क्रॉस-चैनल ग्राहक दृश्य (cross-channel customer view) बनाया। /visitors एंडपॉइंट को हर रात प्रत्येक स्टोर के लिए क्वेरी किया गया था, और डेटा को सामान्य कुंजी के रूप में ईमेल पते का उपयोग करके ई-कॉमर्स लेनदेन रिकॉर्ड के साथ जोड़ा गया था। तीन महीनों के भीतर, एनालिटिक्स टीम ने पहचान लिया था कि इन-स्टोर WiFi से जुड़ने वाले ग्राहकों का उनकी अगली ऑनलाइन खरीदारी पर औसत ऑर्डर मूल्य 34% अधिक था, जो इन-स्टोर डिजिटल अनुभव में आगे के निवेश के लिए एक सम्मोहक व्यावसायिक मामला प्रदान करता है। एकीकरण के लिए मौजूदा ई-कॉमर्स बुनियादी ढांचे में किसी बदलाव की आवश्यकता नहीं थी, जो REST API पुल पैटर्न की कम-घर्षण (low-friction) प्रकृति को प्रदर्शित करता है।

केस स्टडी 3: इवेंट्स — सम्मेलन केंद्र

यूके में एक प्रमुख सम्मेलन केंद्र ने पहली बार प्रायोजकों को सत्यापित फुटफॉल डेटा प्रदान करने के लिए Purple Portal API का उपयोग किया। पहले, प्रायोजक रिपोर्ट मैन्युअल हेडकाउंट और बैज स्कैन पर निर्भर करती थीं, जो श्रम-गहन और गलत थीं। API के माध्यम से प्रति ज़ोन (Purple प्लेटफ़ॉर्म में वेन्यू ID से मैप किए गए) एकत्रित, अनाम विज़िटर काउंट को उजागर करके, इवेंट टीम प्रायोजकों को प्रायोजित क्षेत्रों में ड्वेल टाइम (dwell time) और विज़िटर वॉल्यूम दिखाने वाले रीयल-टाइम डैशबोर्ड प्रदान कर सकती है। इवेंट्स के दौरान हर 15 मिनट में REST API के माध्यम से डेटा खींचा गया और कस्टम-निर्मित प्रायोजक पोर्टल पर प्रदर्शित किया गया। इस क्षमता ने पहले वर्ष में प्रायोजन नवीनीकरण दरों में 22% की वृद्धि में सीधे योगदान दिया, क्योंकि प्रायोजक अब सत्यापित, फर्स्ट-पार्टी डेटा के साथ अपने एक्टिवेशन की पहुंच को माप सकते थे।

मुख्य परिभाषाएं

Webhook

एक स्वचालित तंत्र जहां एक सर्वर HTTP POST रिक्वेस्ट के माध्यम से किसी विशिष्ट घटना के घटित होने पर दूसरे एप्लिकेशन को रीयल-टाइम डेटा अधिसूचना (एक पुश) भेजता है।

Purple संदर्भ में, एक Webhook आपके सिस्टम को JSON पेलोड के साथ विज़िटर डेटा उस क्षण भेजता है जब कोई गेस्ट WiFi नेटवर्क पर प्रमाणित होता है। यह रीयल-टाइम मार्केटिंग और CRM अपडेट के लिए महत्वपूर्ण है।

REST API

वेब सेवाओं के निर्माण के लिए एक मानकीकृत आर्किटेक्चरल शैली जो एक सिस्टम को GET और POST जैसे मानक HTTP तरीकों का उपयोग करके दूसरे से डेटा का अनुरोध करने (या खींचने) की अनुमति देती है।

IT टीमें Power BI या Tableau जैसे बिजनेस इंटेलिजेंस टूल में विश्लेषण के लिए बल्क विज़िटर और वेन्यू डेटा खींचने वाली स्क्रिप्ट लिखने के लिए Purple REST API का उपयोग करती हैं।

API Key Authentication

एक सुरक्षा मॉडल जहां प्रत्येक रिक्वेस्ट के साथ एक अद्वितीय गुप्त टोकन (कुंजी) प्रदान करके API तक पहुंच प्रदान की जाती है, आमतौर पर HTTP Authorization हेडर में।

यह OAuth की तुलना में सरल है और सर्वर-टू-सर्वर एकीकरण के लिए आदर्श है। Purple के डेटा तक पहुँचने के लिए आपकी स्क्रिप्ट को रिक्वेस्ट हेडर में मान्य API Key शामिल करनी होगी।

Idempotency

किसी ऑपरेशन का एक गुण जिसका अर्थ है कि इसे प्रारंभिक अनुप्रयोग से परे परिणाम को बदले बिना कई बार लागू किया जा सकता है।

आपका Webhook लिस्नर इडेम्पोटेंट होना चाहिए। यदि इसे एक ही प्रमाणीकरण घटना दो बार प्राप्त होती है (जो रिट्राइज़ या डिवाइस के पुन: कनेक्ट होने के कारण हो सकता है), तो इसे, उदाहरण के लिए, दो स्वागत ईमेल नहीं भेजने चाहिए।

JSON (JavaScript Object Notation)

डेटा इंटरचेंज के लिए एक हल्का, टेक्स्ट-आधारित फॉर्मेट जिसे इंसानों के लिए पढ़ना और मशीनों के लिए पार्स और जनरेट करना आसान है।

Purple API और Webhooks सभी डेटा JSON फॉर्मेट में डिलीवर करते हैं। ईमेल, नाम और विज़िट काउंट जैसे फ़ील्ड निकालने के लिए आपके एप्लिकेशन को इस JSON को पार्स करने की आवश्यकता होगी।

LogicFlow

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

आप गेस्ट यात्रा को परिभाषित करने के लिए LogicFlow का उपयोग करते हैं। यह वह जगह है जहाँ आप अपना Webhook संलग्न करते हैं, सिस्टम को यह बताते हुए कि जब कोई उपयोगकर्ता अपनी एक्सेस यात्रा की 'Online' स्थिति तक पहुँचता है तो इसे फायर करें।

Captive Portal

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

Purple प्लेटफ़ॉर्म Captive Portal को शक्ति प्रदान करता है, और इस पृष्ठ पर उपयोगकर्ता द्वारा दर्ज किया गया डेटा (जैसे, नाम, ईमेल, कस्टम फ़ील्ड) वह है जो Portal API के माध्यम से उपलब्ध हो जाता है।

GDPR (General Data Protection Regulation)

यूरोपीय संघ में एक व्यापक डेटा गोपनीयता कानून जो यूरोपीय संघ के निवासियों के व्यक्तिगत डेटा के संग्रह, प्रसंस्करण और भंडारण को नियंत्रित करता है।

Purple API GDPR-अनुपालक एकीकरण बनाने के लिए टूल प्रदान करता है, जैसे किसी उपयोगकर्ता की अनसब्सक्राइब स्थिति का सम्मान करना और विषय एक्सेस अनुरोधों के लिए डेटा निर्यात सक्षम करना। v1.7 API अपडेट ने विशेष रूप से अनुपालन का समर्थन करने के लिए अनसब्सक्राइब फ़ील्ड की स्पष्टता में सुधार किया।

ETL (Extract, Transform, Load)

एक डेटा एकीकरण प्रक्रिया जिसमें स्रोत सिस्टम से डेटा निकालना, उसे आवश्यक फॉर्मेट में बदलना और डेटा वेयरहाउस जैसे गंतव्य सिस्टम में लोड करना शामिल है।

REST API पुल पैटर्न को आमतौर पर एक ETL प्रक्रिया के रूप में लागू किया जाता है, जहां डेटा को Purple के `/visitors` एंडपॉइंट से निकाला जाता है, गंतव्य स्कीमा से मेल खाने के लिए रूपांतरित किया जाता है, और CRM या डेटा वेयरहाउस में लोड किया जाता है।

हल किए गए उदाहरण

एक 200 कमरों वाला होटल नए गेस्ट WiFi उपयोगकर्ताओं को स्वचालित रूप से अपनी Salesforce Marketing Cloud यात्रा में जोड़ना और एक स्वागत ईमेल भेजना चाहता है।

  1. Purple पोर्टल में, एक सुरक्षित एंडपॉइंट (जैसे, AWS Lambda पर एक सर्वरलेस फ़ंक्शन) की ओर इशारा करते हुए एक नए Webhook URL को मान्य करें। 2. एक 'Online' LogicFlow बनाएँ जिसमें Webhook नोड शामिल हो, जिसे मान्य URL का उपयोग करने के लिए कॉन्फ़िगर किया गया हो। 3. इस LogicFlow को होटल की गेस्ट WiFi एक्सेस यात्रा (access journey) को असाइन करें। 4. सर्वरलेस फ़ंक्शन गेस्ट प्रमाणीकरण पर JSON पेलोड प्राप्त करता है, उपयोगकर्ता का ईमेल और नाम निकालता है, और उपयोगकर्ता को 'New Guest' यात्रा में जोड़ने के लिए Salesforce Marketing Cloud को API कॉल करता है। 5. फ़ंक्शन 10-सेकंड की टाइमआउट विंडो के भीतर Purple को 200 OK रिस्पॉन्स लौटाता है।
परीक्षक की टिप्पणी: यह समाधान रीयल-टाइम Webhook पैटर्न का सही ढंग से उपयोग करता है, जो स्वागत ईमेल भेजने जैसी तत्काल कार्रवाइयों के लिए आदर्श है। सर्वरलेस फ़ंक्शन का उपयोग करना लिस्नर एंडपॉइंट को होस्ट करने का एक लागत-प्रभावी और स्केलेबल तरीका है। एक विकल्प `/visitors` API एंडपॉइंट को पोल करना होगा, लेकिन यह 24 घंटे तक की देरी पेश करेगा और रीयल-टाइम आवश्यकता के लिए काफी कम कुशल होगा।

50 स्टोर वाली एक रिटेल चेन सभी स्थानों पर विज़िटर रुझानों का विश्लेषण करने के लिए Power BI में एक केंद्रीय डैशबोर्ड बनाना चाहती है।

  1. एक स्क्रिप्ट बनाएँ (जैसे, Python में) जो रात्रिकालीन शेड्यूल पर चलती है। 2. स्क्रिप्ट कंपनी की API Key का उपयोग करके Purple Portal API को प्रमाणित करती है। 3. यह प्रत्येक 50 वेन्यू ID के माध्यम से पुनरावृति (iterate) करती है, पिछले दिन के सभी विज़िटर डेटा को प्राप्त करने के लिए प्रत्येक के लिए /visitors एंडपॉइंट पर कॉल करती है। 4. स्क्रिप्ट इस डेटा को रूपांतरित करती है और एक केंद्रीय डेटा वेयरहाउस (जैसे, Azure SQL या BigQuery) में लोड करती है। 5. क्रॉस-वेन्यू एनालिटिक्स डैशबोर्ड बनाने के लिए Power BI को डेटा वेयरहाउस से जोड़ा जाता है।
परीक्षक की टिप्पणी: यह एक क्लासिक ETL (Extract, Transform, Load) प्रक्रिया है और REST API के पोलिंग पैटर्न का सही उपयोग है। यह बिजनेस इंटेलिजेंस के लिए गैर-रीयल-टाइम, बड़े पैमाने पर डेटा एकत्रीकरण के लिए उपयुक्त है। कई स्रोतों से डेटा से निपटते समय प्रदर्शन और स्केलेबिलिटी के लिए केंद्रीय डेटा वेयरहाउस का उपयोग करना एक सर्वोत्तम प्रथा है। Purple API पर रेट लिमिट्स की अनुपस्थिति का मतलब है कि स्क्रिप्ट थ्रॉटलिंग चिंताओं के बिना सभी 50 वेन्यू को संसाधित कर सकती है।

अभ्यास प्रश्न

Q1. एक स्टेडियम VIP सीज़न टिकट धारकों की पहचान करना चाहता है जब वे WiFi से जुड़ते हैं और निकटतम हॉस्पिटैलिटी मैनेजर के डैशबोर्ड पर एक अधिसूचना भेजना चाहता है। उन्हें किस एकीकरण पैटर्न का उपयोग करना चाहिए और क्यों?

संकेत: अधिसूचना की आवश्यक गति पर विचार करें और क्या कार्रवाई किसी घटना से ट्रिगर होती है।

मॉडल उत्तर देखें

उन्हें Webhook (पुश) पैटर्न का उपयोग करना चाहिए। यह एक रीयल-टाइम आवश्यकता है: जब VIP कनेक्ट होता है, तो एक Webhook तुरंत एक सेवा पर फायर होता है जो सीज़न टिकट धारक डेटाबेस के खिलाफ उपयोगकर्ता के ईमेल या MAC पते को खोजता है। यदि कोई मिलान पाया जाता है, तो यह प्रासंगिक हॉस्पिटैलिटी डैशबोर्ड पर एक अधिसूचना पुश करता है। एक REST API (पुल) पैटर्न बहुत धीमा होगा, क्योंकि यह आवधिक पोलिंग पर निर्भर करता है और मिनटों या घंटों की देरी पेश कर सकता है।

Q2. आपको कॉफी शॉप्स की अपनी राष्ट्रीय चेन में शीर्ष 10 सबसे अधिक देखे जाने वाले वेन्यू की दैनिक रिपोर्ट बनाने का काम सौंपा गया है। आप Purple से आवश्यक डेटा कैसे प्राप्त करेंगे?

संकेत: क्या यह रीयल-टाइम या बैच रिपोर्टिंग आवश्यकता है? आप किस एंडपॉइंट को क्वेरी करेंगे?

मॉडल उत्तर देखें

यह एक बैच रिपोर्टिंग कार्य है, इसलिए REST API (पुल) पैटर्न उपयुक्त है। एक शेड्यूल्ड स्क्रिप्ट प्रतिदिन चलेगी, प्रत्येक वेन्यू के लिए /visitors एंडपॉइंट को क्वेरी करेगी, पिछले दिन के विज़िट काउंट को एकत्रित करेगी, और फिर शीर्ष 10 की गणना करेगी। Webhooks द्वारा प्रदान की जाने वाली नियर-इंस्टेंट अधिसूचना की कोई आवश्यकता नहीं है। रेट लिमिट्स की अनुपस्थिति का मतलब है कि थ्रॉटलिंग चिंताओं के बिना एक ही स्क्रिप्ट रन में सभी वेन्यू को क्वेरी किया जा सकता है।

Q3. आपका Webhook लिस्नर एंडपॉइंट विफल हो रहा है। आप लॉग जांचते हैं और टाइमआउट त्रुटि देखते हैं। Purple के दस्तावेज़ों के अनुसार सबसे संभावित कारण क्या है, और इसके दो तत्काल परिणाम क्या हैं?

संकेत: एक लिस्नर की प्रदर्शन आवश्यकताओं के बारे में सोचें और जब Purple पेलोड डिलीवर नहीं कर पाता है तो वह क्या करता है।

मॉडल उत्तर देखें

सबसे संभावित कारण यह है कि लिस्नर आने वाले JSON पेलोड को संसाधित करने और 200 OK रिस्पॉन्स लौटाने में 10 सेकंड से अधिक समय ले रहा है। दो तत्काल परिणाम हैं: (1) Purple वर्तमान रिक्वेस्ट को भेजने का प्रयास करना बंद कर देगा और इसे 3 घंटे में पुनः प्रयास के लिए कतारबद्ध करेगा, जिसका अर्थ है कि डेटा डिलीवरी में देरी हो रही है; और (2) यदि यह लंबे समय तक जारी रहता है, तो Purple स्वचालित रूप से Webhook को पूरी तरह से अक्षम कर देगा, जिसे फिर से सक्षम करने से पहले पोर्टल में मैन्युअल पुन: सत्यापन की आवश्यकता होगी।

इस श्रृंखला में आगे पढ़ें

Purple WiFi के साथ Huawei AirEngine और CloudCampus एकीकरण

यह गाइड Huawei AirEngine एक्सेस पॉइंट्स और iMaster NCE-Campus को Purple WiFi के साथ एकीकृत करने के लिए चरण-दर-चरण निर्देश प्रदान करती है। इसमें एंटरप्राइज नेटवर्क के लिए कैप्टिव पोर्टल कॉन्फ़िगरेशन, 802.1X स्टाफ प्रमाणीकरण और PPSK डायनेमिक VLAN स्टीयरिंग शामिल है।

गाइड पढ़ें →

Purple WiFi के साथ EnGenius Cloud Access Points का एकीकरण

यह तकनीकी संदर्भ EnGenius Cloud Access Points और ECS स्विचों के Purple के गेस्ट WiFi प्लेटफॉर्म के साथ चरण-दर-चरण एकीकरण का विवरण देता है। इसमें बाहरी स्प्लैश पेज के माध्यम से गेस्ट कैप्टिव पोर्टल रीडायरेक्शन, Walled Garden कॉन्फ़िगरेशन, IEEE 802.1X का उपयोग करके सुरक्षित स्टाफ WiFi, और गतिशील VLAN असाइनमेंट के साथ EnGenius MyPSK का उपयोग करके मल्टी-टेनेंट नेटवर्क अलगाव शामिल है। IT इंस्टॉलरों और नेटवर्क आर्किटेक्ट्स को EnGenius हार्डवेयर संपत्तियों में Purple को तैनात करने के लिए व्यावहारिक कॉन्फ़िगरेशन अनुक्रम, वास्तविक दुनिया के केस स्टडीज और एक समस्या निवारण ढांचा मिलेगा।

गाइड पढ़ें →

Purple WiFi के साथ DrayTek Vigor राउटर्स और एक्सेस पॉइंट्स का एकीकरण

यह गाइड DrayTek Vigor राउटर्स और VigorAP एक्सेस पॉइंट्स को Purple के क्लाउड प्लेटफॉर्म के साथ एकीकृत करने के लिए चरण-दर-चरण तकनीकी निर्देश प्रदान करती है। इसमें Guest WiFi के लिए DrayTek कैप्टिव पोर्टल कॉन्फ़िगरेशन, सुरक्षित Staff WiFi के लिए 802.1X प्रमाणीकरण, Walled Garden सेटअप, और डायनेमिक VLAN असाइनमेंट के साथ मल्टी-टेनेंट नेटवर्क सेगमेंटेशन के लिए DrayTek Multiple PSK (PPSK) कॉन्फ़िगरेशन शामिल है। इसे हॉस्पिटैलिटी, रिटेल और मल्टी-टेनेंट स्थानों पर Purple को तैनात करने वाले IT इंस्टॉलरों और SMB नेटवर्क प्रशासकों के लिए डिज़ाइन किया गया है।

गाइड पढ़ें →