Purple पोर्टल API: तुम्ही यासह काय करू शकता

Purple पोर्टल API चा लाभ घेण्यासाठी IT मॅनेजर्स आणि नेटवर्क आर्किटेक्ट्ससाठी एक तांत्रिक संदर्भ. हे मार्गदर्शक बिझनेस इंटेलिजन्स आणि ऑपरेशनल कार्यक्षमता वाढवण्यासाठी एंटरप्राइझ सिस्टीम्ससह अतिथी WiFi डेटा इंटिग्रेट करण्यासाठी उपलब्ध एंडपॉइंट्स, ऑथेंटिकेशन आणि वास्तविक-जगातील युझ केसेसचे तपशील देते. यात हॉस्पिटॅलिटी, रिटेल आणि इव्हेंट्स क्षेत्रातील ठोस केस स्टडीजसह REST API आणि Webhook इंटिग्रेशन पॅटर्न्स दोन्ही समाविष्ट आहेत.

📖 9 मिनिट वाचन📝 2,212 शब्द🔧 2 सोडवलेली उदाहरणे❓ 3 सराव प्रश्न📚 9 महत्वाच्या व्याख्या

हे मार्गदर्शक ऐका

पॉडकास्ट ट्रान्सक्रिप्ट पहा

Welcome to the Purple Technical Briefing... Purple टेक्निकल ब्रीफिंगमध्ये आपले स्वागत आहे. मी येथे Purple मध्ये एक वरिष्ठ कंटेंट स्ट्रॅटेजिस्ट आहे, आणि पुढील दहा मिनिटांत, मी तुम्हाला आमच्या पोर्टल API चे एक संक्षिप्त, व्यावहारिक विहंगावलोकन देणार आहे — ते काय आहे, तुम्ही त्यासह काय करू शकता आणि जास्तीत जास्त व्यावसायिक प्रभावासाठी त्याचा कसा लाभ घ्यावा. हे IT मॅनेजर्स, आर्किटेक्ट्स आणि ऑपरेशन्स डायरेक्टर्ससाठी आहे ज्यांना त्यांचे अतिथी WiFi एका साध्या सुविधेवरून शक्तिशाली डेटा ॲसेटमध्ये कसे बदलायचे हे जाणून घेण्याची आवश्यकता आहे.

चला संदर्भापासून सुरुवात करूया. तुमच्या ठिकाणांवर अतिथी WiFi आहे. दररोज, शेकडो किंवा हजारो लोक कनेक्ट होतात. ते त्यांचा ईमेल, कदाचित त्यांचे नाव प्रदान करतात आणि ते तुमच्या अटींना संमती देतात. तो मौल्यवान फर्स्ट-पार्टी डेटा आहे. Purple पोर्टल तुम्हाला हे पाहण्यासाठी उत्तम डॅशबोर्ड्स देते, परंतु खरी ताकद तेव्हा येते जेव्हा तुम्ही तो डेटा तुमच्या उर्वरित व्यवसाय इकोसिस्टीमशी जोडता. तिथेच पोर्टल API येते. हा एक पूल आहे जो तुमच्या सिस्टीम्सना आमच्या प्लॅटफॉर्मशी प्रोग्रॅमॅटिकरित्या बोलण्याची अनुमती देतो.

आता, तांत्रिक तपशीलात जाऊया. पोर्टल API एक मानक RESTful इंटरफेस आहे. ऑथेंटिकेशन सोपे आणि सुरक्षित आहे, सरळ API Key वापरून. तुम्हाला सर्व्हर-टू-सर्व्हर कम्युनिकेशनसाठी जटिल OAuth हँडशेक्सबद्दल काळजी करण्याची आवश्यकता नाही. गंभीरपणे, कोणतेही रेट लिमिट्स नाहीत. आम्ही ते एंटरप्राइझ स्केलसाठी तयार केले आहे, त्यामुळे तुम्ही एकच हॉटेल चालवत असाल किंवा पाचशे रिटेल ठिकाणांची राष्ट्रीय चेन, API तुमचा व्हॉल्यूम हाताळू शकते.

तुमच्याकडे डेटा बाहेर काढण्याचे दोन मुख्य मार्ग आहेत. प्रथम, पुल पद्धत: मानक REST एंडपॉइंट्स. visitors आणि venues सारख्या एंडपॉइंट्सचा विचार करा. तुम्ही शेड्युलवर या एंडपॉइंट्सना कॉल करण्यासाठी स्क्रिप्ट लिहू शकता, गेल्या चोवीस तासांतील सर्व अभ्यागत डेटा खेचू शकता आणि विश्लेषणासाठी तुमच्या डेटा वेअरहाऊसमध्ये लोड करू शकता. बिझनेस इंटेलिजन्ससाठी, Power BI किंवा Tableau मध्ये ते मोठे डॅशबोर्ड्स तयार करण्यासाठी हा तुमचा मुख्य मार्ग आहे.

परंतु खरोखर रोमांचक भाग म्हणजे पुश पद्धत: Webhooks. हे रिअल-टाइमसाठी आहे. तुम्ही तुमच्या बाजूला एक लिस्नर एंडपॉइंट सेट करता, आणि ज्या क्षणी एखादा अतिथी तुमच्या WiFi वर ऑथेंटिकेट करतो, आम्ही तुम्हाला त्यांच्या सर्व तपशीलांसह एक JSON पेलोड पाठवतो — नाव, ईमेल, ते कोणत्या ठिकाणी आहेत, त्यांची भेट संख्या आणि त्यांनी वापरलेली ऑथेंटिकेशन पद्धत देखील, मग तो नोंदणी फॉर्म असो, सोशल लॉगिन असो किंवा इतर काही. हे जवळजवळ-त्वरित आहे. हेच त्वरित, वैयक्तिकृत एंगेजमेंट अनलॉक करते. उद्या मार्केटिंग ईमेल पाठवणे आणि एखादा निष्ठावान ग्राहक तुमच्या दारातून आत येताच एका युनिक ऑफरसह वेलकम बॅक नोटिफिकेशन पाठवणे यातील हा फरक आहे.

तुम्हाला मिळणाऱ्या डेटा फील्ड्सबद्दल मी बोलतो. Webhook पेलोड चार मुख्य ऑब्जेक्ट्समध्ये संरचित केलेला आहे. client ऑब्जेक्ट तुम्हाला MAC ॲड्रेस आणि युझर एजंट देतो. company आणि venue ऑब्जेक्ट्स तुम्हाला विशिष्ट ठिकाणाचे आयडेंटिफायर्स आणि जिओ-कोऑर्डिनेट्स देतात. session ऑब्जेक्ट तुम्हाला ऑथेंटिकेशन टाइमस्टॅम्प देतो. आणि user ऑब्जेक्ट तिथे आहे जिथे सोने आहे: नाव, आडनाव, ईमेल, लिंग, जन्मतारीख, मोबाईल नंबर, पोस्टकोड आणि पहिल्या आणि शेवटच्या भेटीच्या तारखा दर्शवणारी प्रति ठिकाण भेट संख्या. तुम्ही तुमच्या स्प्लॅश पेज नोंदणी फॉर्ममधून कस्टम फील्ड्स देखील कॅप्चर करू शकता, त्यामुळे जर तुम्ही अतिथींना त्यांचा लॉयल्टी प्रोग्राम नंबर किंवा हॉटेलमधील त्यांचा रूम नंबर विचारला, तर ते देखील येते.

आता, API च्या आवृत्ती एक पॉईंट सात (v1.7) मध्ये, नोंद घेण्यासारखी एक महत्त्वाची सुधारणा आहे. unsubscribed फील्ड आता पूर्वी सबस्क्राईब केल्यानंतर मार्केटिंगमधून सक्रियपणे बाहेर पडलेले युझर्स विरुद्ध ज्यांनी कधीही ऑप्ट इन केले नाही त्यांच्यात स्पष्टपणे फरक करते. हे GDPR अनुपालनासाठी आणि अचूक सेगमेंटेशनसाठी महत्त्वपूर्ण आहे. तुम्ही लॅप्स झालेल्या सबस्क्रायबरला तुमच्या मार्केटिंग फनेलमध्ये कधीही नसलेल्या व्यक्तीसारखी वागणूक देऊ इच्छित नाही.

चला इंटिग्रेशन पॅटर्न्सबद्दल अधिक तपशीलवार बोलूया. REST API पुल पॅटर्नसाठी, तुमचा सामान्य वर्कफ्लो एक शेड्युल्ड स्क्रिप्ट आहे, कदाचित Python किंवा Node.js मध्ये, जी रात्री चालते. ती तुमच्या API Key सह ऑथेंटिकेट करते, प्रत्येक ठिकाणासाठी visitors एंडपॉइंटची क्वेरी करते, डेटाला तुमच्या आवश्यक फॉरमॅटमध्ये ट्रान्सफॉर्म करते आणि मध्यवर्ती डेटाबेसमध्ये लोड करते. ही एक क्लासिक ETL प्रक्रिया आहे. मल्टी-साइट ऑपरेटरसाठी, तुम्ही तुमच्या व्हेन्यू IDs वरून इटरेट कराल आणि डेटा मध्यवर्ती एकत्रित कराल.

Webhook पुश पॅटर्नसाठी, आर्किटेक्चर थोडे वेगळे आहे. तुम्हाला सार्वजनिकरित्या प्रवेश करण्यायोग्य, SSL-सुरक्षित एंडपॉइंटची आवश्यकता आहे. येथे सर्व्हरलेस फंक्शन आदर्श आहे — AWS Lambda, Azure Functions, किंवा Google Cloud Functions. हे किफायतशीर आहे, आपोआप स्केल होते आणि व्यस्त ठिकाणी तुम्हाला दिसणारी कॉन्करन्सी हाताळते. जेव्हा फंक्शनला Purple कडून POST रिक्वेस्ट प्राप्त होते, तेव्हा त्याने JSON पार्स केले पाहिजे, त्याचे बिझनेस लॉजिक केले पाहिजे — कदाचित CRM लुकअप किंवा लॉयल्टी चेक — आणि शक्य तितक्या लवकर दोनशे (200) OK रिस्पॉन्स परत केला पाहिजे.

हे मला सर्वात महत्त्वाच्या अंमलबजावणी आवश्यकतेकडे आणते: तुमच्या लिस्नरने दहा सेकंदांच्या आत प्रतिसाद दिला पाहिजे. तसे न केल्यास, Purple रिक्वेस्ट पुन्हा रांगेत ठेवेल आणि तीन तासांनंतर पुन्हा प्रयत्न करेल. सततच्या अपयशामुळे सुरक्षिततेच्या कारणास्तव Webhook आपोआप अक्षम होईल. त्यामुळे तुमचा लिस्नर हलका ठेवा. जलद रिस्पॉन्स परत करण्यासाठी आवश्यक असलेले किमान प्रोसेसिंग करा आणि जर तुम्हाला जड प्रोसेसिंग करायचे असेल, तर इव्हेंटला अंतर्गत रांगेत (queue) पुश करा आणि त्यावर असिंक्रोनसपणे प्रक्रिया करा.

आता हे ठोस करण्यासाठी काही वास्तविक-जगातील परिस्थिती पाहूया.

दोनशे खोल्यांच्या हॉटेलचा विचार करा. त्यांना नवीन WiFi अतिथींना त्यांच्या मार्केटिंग प्लॅटफॉर्ममधील स्वागत ईमेल प्रवासात आपोआप नोंदणी करायची आहे. सोल्युशन सरळ आहे: Webhook कॉन्फिगर करा, एक साधा सर्व्हरलेस लिस्नर तयार करा आणि जेव्हा नवीन युझरचा डेटा येतो, तेव्हा ते मार्केटिंग प्लॅटफॉर्ममध्ये आधीपासूनच अस्तित्वात आहेत की नाही ते तपासा. नसल्यास, त्यांना जोडा आणि स्वागत प्रवास ट्रिगर करा. हॉटेल पहिल्यांदा भेट देणारे अभ्यागत आणि परत येणारे अतिथी यांच्यात फरक करण्यासाठी भेट संख्या फील्ड देखील वापरू शकते आणि त्यानुसार कम्युनिकेशन तयार करू शकते. परत येणाऱ्या अतिथीला जेनेरिक स्वागताऐवजी लॉयल्टी रिवॉर्ड ऑफर मिळू शकते.

आता पन्नास स्टोअर्स असलेल्या राष्ट्रीय रिटेल चेनचा विचार करा. त्यांना सर्व ठिकाणांवरील फूट ट्रॅफिक ट्रेंड्स दर्शवणारा मध्यवर्ती डॅशबोर्ड हवा आहे. येथे, REST API पुल पॅटर्न हा योग्य पर्याय आहे. रात्रीची स्क्रिप्ट पन्नास ठिकाणांपैकी प्रत्येकासाठी visitors एंडपॉइंटची क्वेरी करते, डेटा एकत्रित करते आणि डेटा वेअरहाऊसमध्ये लोड करते. ॲनालिटिक्स टीम नंतर यावर त्यांचे डॅशबोर्ड्स तयार करते. ते पाहू शकतात की कोणत्या स्टोअर्समध्ये नवीन अभ्यागतांचे प्रमाण सर्वाधिक आहे, कोणत्या स्टोअर्समध्ये परत येणाऱ्या अभ्यागतांचे प्रमाण सर्वोत्तम आहे आणि ड्वेल टाइम्स विक्रीच्या कामगिरीशी कसे संबंधित आहेत.

आता मी काही सामान्य धोके (pitfalls) आणि ते कसे टाळावे हे कव्हर करतो.

पहिला धोका म्हणजे डुप्लिकेट इव्हेंट हँडलिंग. एकाच अतिथीच्या भेटीमुळे अनेक ऑथेंटिकेशन इव्हेंट्स ट्रिगर होऊ शकतात — उदाहरणार्थ, जर त्यांनी त्यांच्या फोनची स्क्रीन लॉक होऊ दिली आणि ती पुन्हा कनेक्ट झाली, किंवा जर ते ॲक्सेस पॉइंट्स दरम्यान रोम करत असतील. तुमचा लिस्नर आयडेम्पोटेंट असणे आवश्यक आहे. ईमेल पाठवण्यासारखी कृती करण्यापूर्वी, तुम्ही त्या युझरसाठी आज आधीच इव्हेंटवर प्रक्रिया केली आहे की नाही ते तपासा.

दुसरा धोका म्हणजे लाइव्ह जाण्यापूर्वी तुमची लिस्नर URL प्रमाणित न करणे. Purple ला डेटा प्राप्त होण्यापूर्वी तुम्हाला पोर्टलमध्ये एंडपॉइंट प्रमाणित करणे आवश्यक आहे. तुमचा लिस्नर लाइव्ह आहे आणि LogicFlow ला जोडण्यापूर्वी योग्य wifiWebhookListener हेडर परत करत आहे याची खात्री करा.

तिसरा धोका म्हणजे सबस्क्रिप्शन स्टेटसकडे दुर्लक्ष करणे. युझरला मार्केटिंग लिस्टमध्ये जोडण्यापूर्वी नेहमी unsubscribed फील्ड तपासा. बाहेर पडलेल्या (opted out) व्यक्तीला मार्केटिंग कम्युनिकेशन्स पाठवणे हे महत्त्वपूर्ण परिणामांसह GDPR चे उल्लंघन आहे.

आता रॅपिड-फायर प्रश्न आणि उत्तरांच्या सत्रासाठी.

मी हे माझ्या कस्टम-बिल्ट CRM सह सिंक करू शकतो का? होय. जर तुमच्या CRM मध्ये API असेल, तर तुम्ही Purple डेटा फॉरमॅट करण्यासाठी आणि तुमच्या सिस्टीममध्ये पुश करण्यासाठी मिडलवेअर म्हणून Webhook लिस्नर वापरू शकता. Webhook पेलोडमध्ये परत आलेले IDs REST API मधील IDs शी जुळतात, त्यामुळे आवश्यक असल्यास अतिरिक्त तपशील मिळवण्यासाठी तुम्ही फॉलो-अप कॉल्स देखील करू शकता.

माझ्या इस्टेटमधील अनेक साइट्सना भेट देणाऱ्या युझरला मी कसे हाताळू? API प्रति व्हेन्यू ID भेट संख्या प्रदान करते, ज्यामुळे तुम्ही तुमच्या संपूर्ण इस्टेटमध्ये ग्राहकाच्या प्रवासाचा सहज मागोवा घेऊ शकता आणि एक व्यापक क्रॉस-साइट प्रोफाइल तयार करू शकता.

मी किती Webhook URLs कॉन्फिगर करू शकतो यावर काही मर्यादा आहे का? नाही. तुम्ही तुम्हाला आवश्यक तितक्या लिस्नर URLs प्रमाणित आणि वापरू शकता, जे उपयुक्त आहे जर वेगवेगळ्या टीम्स किंवा सिस्टीम्सना समान इव्हेंट डेटा प्राप्त करण्याची आवश्यकता असेल.

माझा लिस्नर देखभालीसाठी (maintenance) डाउन झाल्यास काय होईल? Purple अयशस्वी डिलिव्हरीजचा पुन्हा प्रयत्न करेल, त्यामुळे तुमचा लिस्नर परत ऑनलाइन आल्यावर तुम्हाला इव्हेंट्सचा बॅकलॉग प्राप्त होऊ शकतो. तुमच्या लिस्नरने हे डौलदारपणे (gracefully) हाताळले पाहिजे, कालक्रमानुसार न येणाऱ्या इव्हेंट्सवर प्रक्रिया केली पाहिजे.

आज आपण कव्हर केलेल्या प्रत्येक गोष्टीचा सारांश सांगायचा तर, Purple पोर्टल API ही तुमच्या अतिथी WiFi डेटामधील अफाट मूल्य अनलॉक करण्याची तुमची गुरुकिल्ली आहे. रिपोर्टिंग आणि ॲनालिटिक्ससाठी डेटा खेचण्यासाठी REST API वापरा. त्वरित, वैयक्तिकृत ग्राहक एंगेजमेंटसाठी रिअल-टाइममध्ये डेटा पुश करण्यासाठी Webhooks वापरा. मुख्य तत्त्व लक्षात ठेवा: रिअल-टाइमसाठी पुश, रिपोर्ट्ससाठी पुल.

तुमची पुढची पायरी म्हणजे आमच्या सपोर्ट पोर्टलवरील API डॉक्युमेंटेशनचे पुनरावलोकन करणे. तुमच्याकडे Engage परवाना असल्यास, API Key जनरेट करा आणि Postman सह एक्सप्लोर करणे सुरू करा. एक साधा Webhook लिस्नर तयार करा. डेटा प्रवाहित होताना पहा. तोच क्षण आहे जेव्हा या टूलची क्षमता अगदी स्पष्ट होते.

Purple टेक्निकल ब्रीफिंग ऐकल्याबद्दल धन्यवाद. जर तुम्हाला तुमच्या विशिष्ट इंटिग्रेशन आवश्यकतांबद्दल आमच्या सोल्युशन्स आर्किटेक्ट्सपैकी एकाशी बोलायचे असेल, तर purple dot ai ला भेट द्या आणि डेमो बुक करा. पुढच्या वेळेपर्यंत.

महत्वाचे मुद्दे

✓Purple पोर्टल API कोणत्याही रेट लिमिट्सशिवाय, साध्या API Key ऑथेंटिकेशनचा वापर करून अतिथी WiFi डेटामध्ये प्रोग्रॅमॅटिक ॲक्सेस प्रदान करते.
✓यासाठी Engage परवाना आवश्यक आहे आणि सध्या v1.7 आवृत्तीवर चालते, जिने स्पष्ट unsubscribed स्टेटस हँडलिंगद्वारे GDPR अनुपालन सुधारले आहे.
✓बॅच डेटा एक्सपोर्ट्स, ETL प्रक्रिया आणि ॲनालिटिक्स डॅशबोर्ड्ससाठी REST API (पुल) वापरा.
✓CRM सिंक, वैयक्तिकृत मेसेजिंग आणि लॉयल्टी ट्रिगर्स यासारख्या रिअल-टाइम, इव्हेंट-चालित कृतींसाठी Webhooks (पुश) वापरा.
✓Webhook लिस्नर्स SSL-सुरक्षित असणे आवश्यक आहे, 10 सेकंदांच्या आत प्रतिसाद देणे आणि डुप्लिकेट इव्हेंट्स आयडेम्पोटेंटपणे हाताळण्यासाठी डिझाइन केलेले असणे आवश्यक आहे.
✓प्रमुख युझ केसेस हॉस्पिटॅलिटी (रिअल-टाइम CRM एनरिचमेंट), रिटेल (क्रॉस-चॅनेल ॲनालिटिक्स) आणि इव्हेंट्स (स्पॉन्सर्ससाठी प्रमाणित फूटफॉल डेटा) मध्ये पसरलेल्या आहेत.
✓API संस्थांना त्यांच्या WiFi इन्फ्रास्ट्रक्चरला स्पष्ट, मोजता येण्याजोग्या ROI सह कॉस्ट सेंटरमधून धोरणात्मक डेटा ॲसेटमध्ये रूपांतरित करण्यास सक्षम करते.

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

हॉटेल्स, रिटेल चेन्स, स्टेडियम्स आणि कॉन्फरन्स सेंटर्स यांसारख्या बहु-स्थळ (multi-site) ठिकाणांवरील IT लीडर्ससाठी, अतिथी WiFi नेटवर्क ही केवळ एक साधी सुविधा नाही. हा फर्स्ट-पार्टी डेटाचा एक समृद्ध, सतत भरला जाणारा स्रोत आहे जो मार्केटिंग, ऑपरेशन्स आणि ग्राहक अनुभवामध्ये मोजता येण्याजोगा व्यावसायिक प्रभाव पाडू शकतो. Purple पोर्टल API या मूल्याला मोठ्या प्रमाणावर अनलॉक करण्यासाठी आवश्यक प्रोग्रॅमॅटिक इंटरफेस प्रदान करते. हे तांत्रिक टीम्सना अंगभूत ॲनालिटिक्स डॅशबोर्डच्या पलीकडे जाण्याची आणि मजबूत, स्वयंचलित इंटिग्रेशन्स तयार करण्याची अनुमती देते जे GDPR-सुसंगत अभ्यागत डेटा थेट मुख्य व्यवसाय सिस्टीममध्ये, CRM प्लॅटफॉर्म्स आणि मार्केटिंग ऑटोमेशन टूल्सपासून लॉयल्टी प्रोग्राम्स आणि बिझनेस इंटेलिजन्स वेअरहाऊसपर्यंत फीड करतात.

हे मार्गदर्शक सोल्युशन्स आर्किटेक्ट्स, IT मॅनेजर्स आणि वरिष्ठ डेव्हलपर्ससाठी एक व्यावहारिक, कृती करण्यायोग्य संदर्भ आहे. हे ऑथेंटिकेशन मॉडेल, उपलब्ध एंडपॉइंट्स, इंटिग्रेशन पॅटर्न आणि वास्तविक-जगातील डिप्लॉयमेंट परिस्थितींचे तपशील देते जे दर्शविते की Purple WiFi API कशा प्रकारे WiFi डिप्लॉयमेंटला कॉस्ट सेंटरमधून धोरणात्मक डेटा ॲसेटमध्ये रूपांतरित करू शकते. तुम्ही पहिल्यांदाच API चे मूल्यमापन करत असाल किंवा प्रोडक्शन-ग्रेड इंटिग्रेशनचे नियोजन करत असाल, हा दस्तऐवज तुम्हाला आत्मविश्वासाने पुढे जाण्यासाठी आवश्यक तांत्रिक आधार आणि निर्णय फ्रेमवर्क प्रदान करतो.

तांत्रिक सखोल माहिती (Technical Deep-Dive)

ऑथेंटिकेशन आणि API व्हर्जनिंग

Purple पोर्टल 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 पोर्टल API चा एक प्रमुख आर्किटेक्चरल फायदा म्हणजे कोणतेही रेट लिमिट्स नाहीत. प्लॅटफॉर्म कोणत्याही व्हॉल्यूमच्या रिक्वेस्ट्स किंवा ट्रान्झॅक्शन्सना सपोर्ट करण्यासाठी डिझाइन केलेले आहे, ज्यामुळे ते मोठ्या प्रमाणावरील डिप्लॉयमेंट्ससाठी योग्य बनते जिथे स्क्रिप्ट्सना हजारो ठिकाणांचे रेकॉर्ड्स किंवा लाखो अभ्यागत प्रोफाइल्सवर प्रक्रिया करावी लागू शकते. हे इतर प्लॅटफॉर्म्ससह इंटिग्रेशन डिझाइन गुंतागुंतीचे करणारे एक सामान्य बंधन दूर करते आणि तुमच्या क्लायंट कोडमध्ये रिक्वेस्ट थ्रॉटलिंग किंवा बॅक-ऑफ लॉजिकची आवश्यकता दूर करते.

इंटिग्रेशन पॅटर्न्स: पुल वि. पुश

Purple WiFi API दोन मूलभूतपणे भिन्न इंटिग्रेशन पॅटर्न्सना सपोर्ट करते, प्रत्येक वेगवेगळ्या युझ केसेससाठी योग्य आहे. दिलेल्या परिस्थितीत कोणता पॅटर्न लागू करायचा हे समजून घेणे हा तुम्ही घेणार असलेला सर्वात महत्त्वाचा आर्किटेक्चरल निर्णय आहे.

REST API पुल पॅटर्न मध्ये तुमची सिस्टीम डेटा मिळवण्यासाठी API एंडपॉइंट्सवर ऑन-डिमांड किंवा शेड्युल्ड रिक्वेस्ट्स करते. बॅच प्रोसेसिंग, रिपोर्टिंग आणि बिझनेस इंटेलिजन्ससाठी हा योग्य दृष्टिकोन आहे. मागील दिवसाचा सर्व अभ्यागत डेटा खेचून डेटा वेअरहाऊसमध्ये लोड करणारी रात्रीची ETL स्क्रिप्ट हे एक उत्तम उदाहरण आहे. पुल पॅटर्न तुम्हाला कधी आणि किती डेटा मिळवायचा यावर पूर्ण नियंत्रण देतो.

Webhook पुश पॅटर्न मध्ये विशिष्ट घटना घडल्याक्षणी Purple तुमच्या सिस्टीमला डेटा पाठवते — विशेषतः, जेव्हा एखादा अतिथी WiFi नेटवर्कवर ऑथेंटिकेट करतो. तुमच्या सिस्टीमने सार्वजनिकरित्या प्रवेश करण्यायोग्य, SSL-सुरक्षित HTTP एंडपॉइंट ('लिस्नर') एक्सपोज करणे आवश्यक आहे जे हे JSON POST पेलोड्स प्राप्त करू शकेल आणि त्यावर प्रक्रिया करू शकेल. वैयक्तिकृत स्वागत संदेश ट्रिगर करणे, CRM मध्ये ग्राहकाचे 'शेवटचे पाहिलेले' (last seen) स्टेटस अपडेट करणे किंवा VIP अतिथी आल्याची हॉस्पिटॅलिटी मॅनेजरला सूचना देणे यासारख्या रिअल-टाइम डेटाची आवश्यकता असलेल्या कोणत्याही युझ केससाठी Webhook पॅटर्न हा योग्य पर्याय आहे.

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 एक समर्पित सेटअप मार्गदर्शक प्रदान करते. सर्व्हर-साइड स्क्रिप्टिंगला प्राधान्य देणाऱ्या टीम्ससाठी PHP डेमो फाईल देखील उपलब्ध आहे.

Webhook इंटिग्रेशन कॉन्फिगर करणे

Webhook इंटिग्रेशन डिप्लॉय करण्यामध्ये पाच पायऱ्यांचा समावेश आहे. प्रथम, तुमचा लिस्नर एंडपॉइंट सार्वजनिकरित्या प्रवेश करण्यायोग्य, SSL-सुरक्षित URL वर तयार आणि डिप्लॉय करा. सर्व्हरलेस फंक्शन (AWS Lambda, Azure Functions, किंवा Google Cloud Functions) हा एक आर्किटेक्चरदृष्ट्या योग्य पर्याय आहे: ते आपोआप स्केल होते, कमी व्हॉल्यूमवर कमीत कमी खर्च येतो आणि कॉन्फिगरेशनशिवाय एकाच वेळी अनेक रिक्वेस्ट्स हाताळते. दुसरे, मॅनेजमेंट > व्हेन्यूज > वेबहुक्स (Management > Venues > Webhooks) वर नेव्हिगेट करून Purple पोर्टलमध्ये लिस्नर URL प्रमाणित करा. एंडपॉइंट पोहोचण्यायोग्य आहे आणि आवश्यक wifiWebhookListener: 1 हेडर परत करतो याची पुष्टी करण्यासाठी Purple एक टेस्ट रिक्वेस्ट पाठवेल. तिसरे, पोर्टलमध्ये एक LogicFlow तयार करा किंवा संपादित करा आणि तुमची प्रमाणित URL निवडून Webhook ॲक्शन नोड जोडा. चौथे, LogicFlow 'Online' स्टेटसवर सेट केले असल्याची खात्री करा. पाचवे, संबंधित ॲक्सेस जर्नीला LogicFlow जोडा. या बिंदूपासून, त्या प्रवासावरील प्रत्येक अतिथी ऑथेंटिकेशन तुमचा Webhook ट्रिगर करेल.

रिट्राइज आणि आयडेम्पोटेन्सी हाताळणे

तुमचा लिस्नर डिस्ट्रिब्युटेड सिस्टीम्सच्या वास्तवांना हाताळण्यासाठी डिझाइन केलेला असणे आवश्यक आहे. तुमचा लिस्नर प्रतिसाद देत नसल्यास (टाइमआउट 10 सेकंदांपेक्षा जास्त) किंवा एरर स्टेटस परत करत असल्यास Purple तीन तासांनंतर अयशस्वी Webhook डिलिव्हरीचा पुन्हा प्रयत्न करेल. याचा अर्थ तुमच्या लिस्नरला तोच इव्हेंट अनेक वेळा प्राप्त होऊ शकतो. शिवाय, एकाच अतिथीच्या भेटीमुळे अनेक ऑथेंटिकेशन इव्हेंट्स ट्रिगर होऊ शकतात — उदाहरणार्थ, जेव्हा स्क्रीन लॉक झाल्यानंतर डिव्हाइस पुन्हा कनेक्ट होते किंवा जेव्हा युझर ॲक्सेस पॉइंट्स दरम्यान रोम करतो. त्यामुळे तुमचे प्रोसेसिंग लॉजिक आयडेम्पोटेंट (idempotent) असणे आवश्यक आहे: तोच इव्हेंट दोनदा लागू केल्याने तो एकदा लागू केल्यासारखाच परिणाम मिळायला हवा. एक सामान्य अंमलबजावणी पॅटर्न म्हणजे एखादी कृती (जसे की स्वागत ईमेल पाठवणे) कार्यान्वित करण्यापूर्वी परिभाषित वेळेच्या विंडोमध्ये दिलेल्या युझर ID साठी आधीच केली गेली आहे की नाही हे तपासणे.

सर्वोत्तम पद्धती (Best Practices)

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

ट्रबलशूटिंग आणि जोखीम निवारण

Webhook इंटिग्रेशनमधील सर्वात सामान्य अपयश म्हणजे संथ किंवा अनुपलब्ध लिस्नर. जर एंडपॉइंट सातत्याने 10 सेकंदांच्या आत प्रतिसाद देण्यात अयशस्वी झाला, तर दीर्घकाळ प्रतिसाद न दिल्यास Purple आपोआप Webhook अक्षम करेल, ज्यासाठी पोर्टलमध्ये मॅन्युअल री-व्हेरिफिकेशन आवश्यक असेल. ही जोखीम कमी करण्यासाठी, तुमच्या लिस्नरच्या त्याच सर्व्हरवर हेल्थ चेक एंडपॉइंट लागू करा आणि तुमच्या इन्फ्रास्ट्रक्चर मॉनिटरिंगमध्ये त्याचा समावेश करा. 200 OK रिस्पॉन्स परत करण्यापूर्वी तुमचा लिस्नर केवळ कमीत कमी सिंक्रोनस प्रोसेसिंग करत असल्याची खात्री करा; कोणतेही जड कॉम्प्युटेशन किंवा डाउनस्ट्रीम API कॉल्स असिंक्रोनस रांगेत (queue) ऑफलोड करा.

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

ROI आणि व्यावसायिक प्रभाव

Purple पोर्टल API सह इंटिग्रेट करण्यासाठी बिझनेस केस अनेक व्हर्टिकल्समध्ये प्रस्थापित आहे. हॉस्पिटॅलिटीमध्ये, Webhook-ट्रिगर केलेले CRM इंटिग्रेशन्स वापरणारी हॉटेल्स जेनेरिक ब्रॉडकास्ट मोहिमांच्या तुलनेत वैयक्तिकृत कम्युनिकेशन्ससाठी ईमेल ओपन रेट्समध्ये लक्षणीय सुधारणा नोंदवतात, कारण संदेश जास्तीत जास्त प्रासंगिकतेच्या क्षणी वितरित केला जातो — जेव्हा अतिथी प्रत्यक्ष जागेवर असतो. रिटेलमध्ये, अतिथी WiFi डेटाला लॉयल्टी प्रोग्रामशी जोडल्याने ऑपरेटर्सना उच्च-वारंवारता असलेल्या अभ्यागतांना ओळखण्यास आणि बक्षीस देण्यास सक्षम करते, ज्यामुळे सरासरी खर्च आणि पुन्हा भेट देण्याचे प्रमाण वाढते. मोठ्या सार्वजनिक ठिकाणांसाठी आणि कॉन्फरन्स सेंटर्ससाठी, API-चालित ॲनालिटिक्स स्पॉन्सरशिप व्हॅल्युएशन्सचे समर्थन करण्यासाठी आणि कन्सेशन प्लेसमेंट ऑप्टिमाइझ करण्यासाठी आवश्यक ग्रॅन्युलर फूटफॉल डेटा प्रदान करतात.

Purple WiFi API वर रेट लिमिट्स नसणे याचा अर्थ असा आहे की इंटिग्रेशनचा खर्च तुमच्या इन्फ्रास्ट्रक्चरसह वाढतो, तुम्ही प्रक्रिया करत असलेल्या डेटाच्या व्हॉल्यूमसह नाही. दररोज लाखो ऑथेंटिकेशन्सवर प्रक्रिया करणाऱ्या राष्ट्रीय रिटेल चेनसाठी, प्रति API कॉल शुल्क आकारणाऱ्या किंवा थ्रूपुट कॅप्स लादणाऱ्या प्लॅटफॉर्म्सच्या तुलनेत हा एक भौतिक फायदा आहे. त्यामुळे चांगल्या प्रकारे आर्किटेक्ट केलेल्या Purple API इंटिग्रेशनची एकूण मालकी किंमत (TCO) प्रामुख्याने एकवेळचा डेव्हलपमेंट खर्च आणि लिस्नरचा चालू इन्फ्रास्ट्रक्चर खर्च आहे, जे दोन्ही सामान्यतः केवळ सुधारित मार्केटिंग कन्व्हर्जन रेट्सद्वारे पहिल्या तिमाहीत वसूल केले जातात.

केस स्टडीज

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

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

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

80 पेक्षा जास्त स्टोअर्स असलेल्या एका राष्ट्रीय फॅशन रिटेलरने त्यांच्या ग्राहक डेटा धोरणातील एक गंभीर अंतर दूर करण्यासाठी Purple पोर्टल API डिप्लॉय केले: त्यांच्याकडे मजबूत ई-कॉमर्स डेटा होता परंतु इन-स्टोअर अभ्यागतांच्या वर्तनाबद्दल अक्षरशः कोणतीही माहिती नव्हती. रात्रीच्या ETL प्रक्रियेद्वारे Purple अतिथी WiFi API ला त्यांच्या विद्यमान डेटा वेअरहाऊसशी जोडून, त्यांनी पहिल्यांदाच क्रॉस-चॅनेल ग्राहक दृश्य तयार केले. प्रत्येक स्टोअरसाठी रात्री /visitors एंडपॉइंटची क्वेरी केली गेली आणि सामान्य की म्हणून ईमेल पत्ता वापरून ई-कॉमर्स ट्रान्झॅक्शन रेकॉर्ड्ससह डेटा जोडला गेला. तीन महिन्यांच्या आत, ॲनालिटिक्स टीमने ओळखले की इन-स्टोअर WiFi शी कनेक्ट झालेल्या ग्राहकांचे त्यांच्या पुढील ऑनलाइन खरेदीवर सरासरी ऑर्डर मूल्य 34% जास्त होते, ज्यामुळे इन-स्टोअर डिजिटल अनुभवामध्ये पुढील गुंतवणूकीसाठी एक आकर्षक बिझनेस केस मिळाली. इंटिग्रेशनसाठी विद्यमान ई-कॉमर्स इन्फ्रास्ट्रक्चरमध्ये कोणतेही बदल करण्याची आवश्यकता नव्हती, जे REST API पुल पॅटर्नचे लो-फ्रिक्शन स्वरूप दर्शवते.

केस स्टडी 3: इव्हेंट्स — कॉन्फरन्स सेंटर

UK मधील एका प्रमुख कॉन्फरन्स सेंटरने पहिल्यांदाच स्पॉन्सर्सना प्रमाणित फूटफॉल डेटा प्रदान करण्यासाठी Purple पोर्टल API चा वापर केला. पूर्वी, स्पॉन्सर रिपोर्ट्स मॅन्युअल हेडकाउंट्स आणि बॅज स्कॅन्सवर अवलंबून होते, जे श्रम-केंद्रित आणि चुकीचे होते. API द्वारे प्रति झोन (Purple प्लॅटफॉर्ममधील व्हेन्यू IDs वर मॅप केलेले) एकत्रित, निनावी अभ्यागत संख्या एक्सपोज करून, इव्हेंट्स टीम स्पॉन्सर्सना स्पॉन्सर्ड क्षेत्रांमध्ये ड्वेल टाइम आणि अभ्यागतांची संख्या दर्शवणारे रिअल-टाइम डॅशबोर्ड प्रदान करू शकली. इव्हेंट्स दरम्यान दर 15 मिनिटांनी REST API द्वारे डेटा खेचला गेला आणि कस्टम-बिल्ट स्पॉन्सर पोर्टलवर प्रदर्शित केला गेला. या क्षमतेने पहिल्या वर्षात स्पॉन्सरशिप नूतनीकरण दरांमध्ये 22% वाढीस थेट योगदान दिले, कारण स्पॉन्सर्स आता प्रमाणित, फर्स्ट-पार्टी डेटासह त्यांच्या ॲक्टिव्हेशन्सची पोहोच मोजू शकत होते.

महत्वाच्या व्याख्या

Webhook

एक स्वयंचलित यंत्रणा जिथे सर्व्हर HTTP POST रिक्वेस्टद्वारे विशिष्ट घटना घडल्यावर दुसऱ्या ॲप्लिकेशनला रिअल-टाइम डेटा नोटिफिकेशन (पुश) पाठवतो.

Purple च्या संदर्भात, जेव्हा एखादा अतिथी WiFi नेटवर्कवर ऑथेंटिकेट करतो तेव्हा Webhook तुमच्या सिस्टीमला अभ्यागत डेटासह JSON पेलोड पाठवतो. रिअल-टाइम मार्केटिंग आणि 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 लिस्नर आयडेम्पोटेंट (idempotent) असावा. जर त्याला तोच ऑथेंटिकेशन इव्हेंट दोनदा प्राप्त झाला (जे रिट्राइज किंवा डिव्हाइस रीकनेक्शन्समुळे होऊ शकते), तर त्याने, उदाहरणार्थ, दोन स्वागत ईमेल पाठवू नयेत.

JSON (JavaScript Object Notation)

डेटा इंटरचेंजसाठी एक हलका, मजकूर-आधारित फॉरमॅट जो मानवांना वाचण्यास सोपा आणि मशीनला पार्स आणि जनरेट करण्यास सोपा आहे.

Purple API आणि Webhooks सर्व डेटा JSON फॉरमॅटमध्ये वितरित करतात. ईमेल, नाव आणि भेट संख्या यासारखे फील्ड्स एक्सट्रॅक्ट करण्यासाठी तुमच्या ॲप्लिकेशनला हे JSON पार्स करावे लागेल.

LogicFlow

स्वयंचलित मार्केटिंग आणि एंगेजमेंट वर्कफ्लो तयार करण्यासाठी Purple चे व्हिज्युअल, ड्रॅग-अँड-ड्रॉप टूल जे अभ्यागतांचे वर्तन आणि डेमोग्राफिक्सवर आधारित कृती ट्रिगर करू शकते.

अतिथी प्रवास परिभाषित करण्यासाठी तुम्ही LogicFlow वापरता. येथे तुम्ही तुमचा Webhook जोडता, सिस्टीमला सांगता की जेव्हा युझर त्यांच्या ॲक्सेस जर्नीच्या 'Online' स्थितीत पोहोचतो तेव्हा ते फायर करा.

Captive Portal

सार्वजनिक WiFi नेटवर्कवर प्रवेश देण्यापूर्वी युझरला दिसणारे आणि संवाद साधावे लागणारे वेब पेज, ज्यासाठी सामान्यतः ऑथेंटिकेशन किंवा डेटा कॅप्चर आवश्यक असते.

Purple प्लॅटफॉर्म Captive Portal ला पॉवर देते, आणि या पेजवर युझरने एंटर केलेला डेटा (उदा. नाव, ईमेल, कस्टम फील्ड्स) पोर्टल API द्वारे उपलब्ध होतो.

GDPR (General Data Protection Regulation)

युरोपियन युनियनमधील एक व्यापक डेटा गोपनीयता कायदा जो EU रहिवाशांच्या वैयक्तिक डेटाचे संकलन, प्रक्रिया आणि स्टोरेज नियंत्रित करतो.

Purple API GDPR-सुसंगत इंटिग्रेशन्स तयार करण्यासाठी टूल्स प्रदान करते, जसे की युझरच्या अनसबस्क्राईब केलेल्या स्थितीचा आदर करणे आणि सब्जेक्ट ॲक्सेस रिक्वेस्ट्ससाठी डेटा एक्सपोर्ट सक्षम करणे. v1.7 API अपडेटने विशेषतः अनुपालनास समर्थन देण्यासाठी unsubscribed फील्डची स्पष्टता सुधारली.

ETL (Extract, Transform, Load)

एक डेटा इंटिग्रेशन प्रक्रिया ज्यामध्ये स्रोत सिस्टीममधून डेटा एक्सट्रॅक्ट करणे, आवश्यक फॉरमॅटमध्ये ट्रान्सफॉर्म करणे आणि डेटा वेअरहाऊससारख्या डेस्टिनेशन सिस्टीममध्ये लोड करणे समाविष्ट असते.

REST API पुल पॅटर्न सामान्यतः ETL प्रक्रिया म्हणून लागू केला जातो, जिथे Purple च्या /visitors एंडपॉइंटवरून डेटा एक्सट्रॅक्ट केला जातो, डेस्टिनेशन स्कीमाशी जुळण्यासाठी ट्रान्सफॉर्म केला जातो आणि CRM किंवा डेटा वेअरहाऊसमध्ये लोड केला जातो.

सोडवलेली उदाहरणे

एका 200-खोल्यांच्या हॉटेलला नवीन अतिथी WiFi युझर्सना त्यांच्या Salesforce Marketing Cloud प्रवासात आपोआप जोडायचे आहे आणि स्वागत ईमेल पाठवायचा आहे.

Purple पोर्टलमध्ये, सुरक्षित एंडपॉइंटकडे (उदा. AWS Lambda वरील सर्व्हरलेस फंक्शन) निर्देशित करणारी नवीन Webhook URL प्रमाणित करा. 2. प्रमाणित URL वापरण्यासाठी कॉन्फिगर केलेला Webhook नोड समाविष्ट करणारा 'Online' LogicFlow तयार करा. 3. हा LogicFlow हॉटेलच्या अतिथी WiFi ॲक्सेस जर्नीला असाइन करा. 4. सर्व्हरलेस फंक्शनला अतिथी ऑथेंटिकेशनवर JSON पेलोड प्राप्त होतो, युझरचा ईमेल आणि नाव एक्सट्रॅक्ट करते आणि युझरला 'New Guest' प्रवासात जोडण्यासाठी Salesforce Marketing Cloud ला API कॉल करते. 5. फंक्शन 10-सेकंदांच्या टाइमआउट विंडोमध्ये Purple ला 200 OK रिस्पॉन्स परत करते.

परीक्षकाचे भाष्य: हे सोल्युशन रिअल-टाइम Webhook पॅटर्न योग्यरित्या वापरते, जे स्वागत ईमेल पाठवण्यासारख्या त्वरित कृतींसाठी आदर्श आहे. सर्व्हरलेस फंक्शन वापरणे हा लिस्नर एंडपॉइंट होस्ट करण्याचा एक किफायतशीर आणि स्केलेबल मार्ग आहे. एक पर्याय म्हणजे /visitors API एंडपॉइंट पोल करणे, परंतु यामुळे 24 तासांपर्यंत विलंब होईल आणि रिअल-टाइम आवश्यकतेसाठी ते लक्षणीयरीत्या कमी कार्यक्षम असेल.

50 स्टोअर्स असलेल्या रिटेल चेनला सर्व ठिकाणांवरील अभ्यागतांच्या ट्रेंडचे विश्लेषण करण्यासाठी Power BI मध्ये एक मध्यवर्ती डॅशबोर्ड तयार करायचा आहे.

रात्रीच्या शेड्युलवर चालणारी स्क्रिप्ट (उदा. Python मध्ये) तयार करा. 2. स्क्रिप्ट कंपनीची API Key वापरून Purple पोर्टल API वर ऑथेंटिकेट करते. 3. ती 50 व्हेन्यू IDs पैकी प्रत्येकावर इटरेट करते, मागील दिवसाचा सर्व अभ्यागत डेटा मिळवण्यासाठी प्रत्येकासाठी /visitors एंडपॉइंटला कॉल करते. 4. स्क्रिप्ट या डेटाचे रूपांतर करते आणि मध्यवर्ती डेटा वेअरहाऊसमध्ये (उदा. Azure SQL किंवा BigQuery) लोड करते. 5. क्रॉस-व्हेन्यू ॲनालिटिक्स डॅशबोर्ड तयार करण्यासाठी Power BI डेटा वेअरहाऊसशी जोडलेले आहे.

परीक्षकाचे भाष्य: ही एक क्लासिक ETL (Extract, Transform, Load) प्रक्रिया आहे आणि REST API च्या पोलिंग पॅटर्नचा योग्य वापर आहे. बिझनेस इंटेलिजन्ससाठी नॉन-रिअल-टाइम, मोठ्या प्रमाणावरील डेटा एकत्रीकरणासाठी हे योग्य आहे. एकाधिक स्रोतांमधून डेटा हाताळताना कार्यप्रदर्शन आणि स्केलेबिलिटीसाठी मध्यवर्ती डेटा वेअरहाऊस वापरणे ही एक सर्वोत्तम पद्धत आहे. Purple API वर रेट लिमिट्स नसणे याचा अर्थ असा आहे की स्क्रिप्ट थ्रॉटलिंगच्या चिंतेशिवाय सर्व 50 ठिकाणांवर प्रक्रिया करू शकते.

सराव प्रश्न

Q1. एका स्टेडियमला VIP सीझन तिकीट धारक WiFi शी कनेक्ट झाल्यावर त्यांना ओळखायचे आहे आणि जवळच्या हॉस्पिटॅलिटी मॅनेजरच्या डॅशबोर्डवर नोटिफिकेशन पाठवायचे आहे. त्यांनी कोणता इंटिग्रेशन पॅटर्न वापरावा आणि का?

टीप: नोटिफिकेशनच्या आवश्यक गतीचा विचार करा आणि कृती एखाद्या इव्हेंटद्वारे ट्रिगर केली जाते की नाही याचा विचार करा.

नमुना उत्तर पहा

त्यांनी Webhook (पुश) पॅटर्न वापरावा. ही एक रिअल-टाइम आवश्यकता आहे: जेव्हा VIP कनेक्ट होतो, तेव्हा सीझन तिकीट धारक डेटाबेस विरुद्ध युझरचा ईमेल किंवा MAC ॲड्रेस शोधणाऱ्या सेवेवर Webhook त्वरित फायर होतो. जर जुळणी आढळली, तर ते संबंधित हॉस्पिटॅलिटी डॅशबोर्डवर नोटिफिकेशन पुश करते. REST API (पुल) पॅटर्न खूप संथ असेल, कारण तो नियतकालिक पोलिंगवर अवलंबून असतो आणि त्यामुळे मिनिटे किंवा तासांचा विलंब होऊ शकतो.

Q2. तुमच्या कॉफी शॉप्सच्या राष्ट्रीय चेनमध्ये सर्वाधिक भेट दिलेल्या टॉप 10 ठिकाणांचा दैनिक अहवाल तयार करण्याचे काम तुम्हाला दिले आहे. तुम्ही Purple कडून आवश्यक डेटा कसा मिळवाल?

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

नमुना उत्तर पहा

हे एक बॅच रिपोर्टिंग कार्य आहे, त्यामुळे REST API (पुल) पॅटर्न योग्य आहे. एक शेड्युल्ड स्क्रिप्ट दररोज चालेल, प्रत्येक ठिकाणासाठी /visitors एंडपॉइंटची क्वेरी करेल, मागील दिवसाच्या भेट संख्या एकत्रित करेल आणि नंतर टॉप 10 ची गणना करेल. Webhooks द्वारे प्रदान केलेल्या जवळजवळ-त्वरित नोटिफिकेशनची आवश्यकता नाही. रेट लिमिट्स नसणे याचा अर्थ असा आहे की थ्रॉटलिंगच्या चिंतेशिवाय एकाच स्क्रिप्ट रनमध्ये सर्व ठिकाणांची क्वेरी केली जाऊ शकते.

Q3. तुमचा Webhook लिस्नर एंडपॉइंट अयशस्वी होत आहे. तुम्ही लॉग्स तपासता आणि टाइमआउट एरर पाहता. Purple च्या डॉक्युमेंटेशननुसार सर्वात संभाव्य कारण काय आहे आणि त्याचे दोन तात्काळ परिणाम काय आहेत?

टीप: लिस्नरच्या कार्यप्रदर्शन आवश्यकतांचा विचार करा आणि जेव्हा Purple पेलोड वितरित करू शकत नाही तेव्हा ते काय करते याचा विचार करा.

नमुना उत्तर पहा

सर्वात संभाव्य कारण म्हणजे लिस्नरला येणाऱ्या JSON पेलोडवर प्रक्रिया करण्यासाठी आणि 200 OK रिस्पॉन्स परत करण्यासाठी 10 सेकंदांपेक्षा जास्त वेळ लागत आहे. दोन तात्काळ परिणाम आहेत: (1) Purple वर्तमान रिक्वेस्ट पाठवण्याचा प्रयत्न थांबवेल आणि 3 तासांनंतर पुन्हा प्रयत्न करण्यासाठी रांगेत (requeue) ठेवेल, याचा अर्थ डेटा डिलिव्हरीला विलंब होतो; आणि (2) जर हे दीर्घकाळ चालू राहिले, तर Purple आपोआप Webhook पूर्णपणे अक्षम करेल, ज्यासाठी ते पुन्हा सक्षम करण्यापूर्वी पोर्टलमध्ये मॅन्युअल री-व्हेरिफिकेशन आवश्यक असेल.

या मालिकेमध्ये पुढे वाचा

DrayTek Vigor राउटर आणि ऍक्सेस पॉईंट्सचे Purple WiFi सोबत एकत्रीकरण

हे मार्गदर्शक DrayTek Vigor राउटर आणि VigorAP ऍक्सेस पॉईंट्सना Purple च्या क्लाउड प्लॅटफॉर्मसह एकत्रित करण्यासाठी टप्प्याटप्प्याने तांत्रिक सूचना प्रदान करते. यामध्ये Guest WiFi साठी DrayTek Captive Portal कॉन्फिगरेशन, सुरक्षित Staff WiFi साठी 802.1X ऑथेंटिकेशन, Walled Garden सेटअप आणि डायनॅमिक VLAN असाइनमेंटसह मल्टी-टेनंट नेटवर्क सेगमेंटेशनसाठी DrayTek Multiple PSK (PPSK) कॉन्फिगरेशन समाविष्ट आहे. हे हॉस्पिटॅलिटी, रिटेल आणि मल्टी-टेनंट ठिकाणी Purple तैनात करणाऱ्या IT इंस्टॉलर्स आणि SMB नेटवर्क प्रशासकांसाठी डिझाइन केले आहे.

Purple WiFi सह Zyxel Nebula Cloud आणि USG Integration

हे तांत्रिक संदर्भ मार्गदर्शक Zyxel Nebula Cloud आणि USG Flex Firewalls चे Purple WiFi प्लॅटफॉर्मसोबतच्या एंड-टू-एंड Integration बद्दल माहिती देते. हे गेस्ट Captive Portal रिडायरेक्शन, RADIUS ऑथेंटिकेशन, Walled Garden सेटअप, 802.1X वापरून सुरक्षित Staff WiFi, आणि डायनॅमिक VLAN असाइनमेंटसह Zyxel Private Pre-Shared Keys (PPSK) वापरून मल्टी-टेनंट नेटवर्क सेगमेंटेशनसाठी टप्प्याटप्प्याने कॉन्फिगरेशन सूचना प्रदान करते. हॉस्पिटॅलिटी, रिटेल आणि मल्टी-टेनंट ठिकाणी WiFi तैनात करणारे IT मॅनेजर्स, MSPs आणि नेटवर्क आर्किटेक्ट्सना PCI DSS, IEEE 802.1X आणि GDPR सह उद्योग मानकांवर आधारित कृतीयोग्य मार्गदर्शन मिळेल.

Alcatel-Lucent Enterprise (ALE) OmniAccess चे Purple WiFi सोबत एकत्रीकरण

हे मार्गदर्शक Alcatel-Lucent Enterprise (ALE) OmniAccess Stellar ॲक्सेस पॉइंट्स आणि Purple WiFi मधील तांत्रिक एकत्रीकरणाचा तपशील देते. यामध्ये Captive Portal रिडायरेक्शन, RADIUS ऑथेंटिकेशन, Walled Garden कॉन्फिगरेशन, सुरक्षित 802.1X Staff WiFi, आणि प्रायव्हेट प्री-शेअर्ड की (PPSK) सह डायनॅमिक VLAN स्टिअरिंग वापरून मल्टी-टेनंट WiFi सेगमेंटेशन समाविष्ट आहे - जे IT व्यवस्थापक आणि नेटवर्क आर्किटेक्ट्सना ALE हार्डवेअरवर आयडेंटिटी-बेस्ड नेटवर्क्स तैनात करण्यासाठी एक संपूर्ण, कृतीयोग्य संदर्भ प्रदान करते.