WiFi QR कोड API गाइड

एक Wi-Fi QR कोड कोई URL एनकोड नहीं करता। यह एक सादा-मतन कॉन्फ़िगरेशन स्ट्रिंग एनकोड करता है जिसे फोन कैमरे पहचानते हैं और उस पर काम करने की पेशकश करते हैं, इस बनावट में:

WIFI:T:WPA;S:MyNetwork;P:MyPassword;H:false;;

फील्ड:

• T: — सुरक्षा प्रकार। स्कैनिंग के लिहाज़ से WPA WPA, WPA2 और WPA3 को कवर करता है। पुराने नेटवर्क के लिए WEP। खुले नेटवर्क के लिए nopass।
• S: — SSID (नेटवर्क का नाम), ठीक वैसा जैसा प्रसारित होता है, केस-संवेदी।
• P: — पासवर्ड। nopass नेटवर्क के लिए इसे पूरी तरह हटा दें।
• H: — SSID छिपा हो तो true, वरना false या हटा दें।
• दोहरा सेमीकोलन ;; स्ट्रिंग को समाप्त करता है और ज़रूरी है।

फील्ड का क्रम मायने नहीं रखता — WIFI:S:...;T:...;P:...;; भी उतना ही वैध है। SMLLR इन्हें T, S, P, H क्रम में लिखता है।

क्योंकि यह URL के बजाय कच्चा कॉन्फ़िगरेशन डेटा है, वेब-सेवा के अर्थ में वाकई कोई सर्वर शामिल नहीं है और कोई wifi qr code api नहीं है। "API" यही स्ट्रिंग फॉर्मेट है और साथ में वह लाइब्रेरी जिससे आप इसे इमेज में बदलते हैं।

चुपचाप फेल होने वाले Wi-Fi QR कोड की यह सबसे आम वजह है, और इसे बिल्कुल सही करना ज़रूरी है।

अक्षर \, ;, ,, : और " WIFI: फॉर्मेट के भीतर विशेष हैं और जब वे किसी SSID या पासवर्ड के अंदर आएं तो उन्हें बैकस्लैश से एस्केप करना ही पड़ता है। Guest;2026 पासवर्ड को Guest\;2026 के रूप में एनकोड करना होगा, वरना पार्सर सेमीकोलन को फील्ड समाप्ति मानकर एक कटा हुआ पासवर्ड पढ़ेगा।

यह भारत में कहीं और से ज़्यादा मायने रखता है, क्योंकि ISP से मिले उपकरणों के जेनरेट किए राउटर पासवर्ड में अक्सर ठीक यही अक्षर होते हैं। बिना एस्केप किए सेमीकोलन वाला कोड स्कैन करने वाले मेहमान को बिना किसी काम की त्रुटि के कनेक्शन विफलता मिलती है — फोन बस गलत पासवर्ड बता देता है।

एक और किनारे का मामला: सिर्फ हेक्साडेसिमल अक्षरों से बना SSID एक शाब्दिक स्ट्रिंग के बजाय हेक्स-एनकोडेड मान के रूप में अस्पष्ट रूप से समझा जा सकता है। परंपरा है ऐसे SSID को दोहरे उद्धरण में लपेटना — S:"ABCD1234"; — ताकि शाब्दिक व्याख्या मजबूर हो। दुर्लभ, लेकिन जब होता है तो वाकई तोड़ देता है।

200 कमरों वाले होटल, प्रति-मंज़िल गेस्ट नेटवर्क वाले ऑफिस, या प्रति लोकेशन एक नेटवर्क वाले कोवर्किंग ऑपरेटर के लिए, आप इन्हें अपने बैकएंड में बनाते हैं।

Python, एस्केपिंग ठीक से संभालते हुए:

import qrcode

SPECIAL = ['\\', ';', ',', ':', '"']

def esc(value: str) -> str:
    for ch in SPECIAL:
        value = value.replace(ch, '\\' + ch)
    return value

def wifi_qr(ssid: str, password: str, security: str, hidden: bool, out_path: str):
    payload = f"WIFI:T:{security};S:{esc(ssid)};P:{esc(password)};H:{str(hidden).lower()};;"
    qrcode.make(payload).save(out_path)

wifi_qr("HotelGuest_301", "Stay;Well2026", "WPA", False, "room_301.png")

ध्यान दें कि एस्केप फ़ंक्शन SSID और पासवर्ड पर चलता है, जुड़े हुए पेलोड पर नहीं — पूरी स्ट्रिंग एस्केप करना फील्ड विभाजक ही तोड़ देगा।

हमारी Python QR कोड API गाइड लाइब्रेरी विकल्प और आउटपुट फॉर्मेट को और गहराई से बताती है, जिसमें प्रिंट के लिए वेक्टर फाइल एक्सपोर्ट करना भी शामिल है।

आधुनिक फोन पर Wi-Fi QR समर्थन अच्छा है लेकिन सार्वभौमिक नहीं, और 200 रूम कार्ड प्रिंट करने से पहले विफलता के तरीके जानना ज़रूरी है:

• iOS और आधुनिक एंड्रॉइड दोनों नेटिव कैमरे से WIFI: फॉर्मेट पहचानते हैं और जुड़ने का प्रॉम्प्ट देते हैं। यह अधिकांश मेहमानों को कवर करता है।
• पुराने एंड्रॉइड डिवाइस को एक समर्पित स्कैनर ऐप चाहिए हो सकता है, या वे इसे बिल्कुल भी समर्थित न करें। कुछ साल पुराने एंट्री-लेवल हैंडसेट पर कैमरा बस कच्ची स्ट्रिंग दिखा सकता है।
• एंटरप्राइज़ नेटवर्क जो WPA2-Enterprise या 802.1X ऑथेंटिकेशन इस्तेमाल करते हैं, इस फॉर्मेट से कवर नहीं होते। यूज़रनेम या सर्टिफिकेट के लिए कोई फील्ड नहीं है। अगर आपके गेस्ट नेटवर्क को लॉगिन पोर्टल चाहिए, तो एक Wi-Fi QR कोड उसे बायपास नहीं कर सकता।
• कैप्टिव पोर्टल। एक कोड नेटवर्क से जोड़ सकता है, लेकिन अगर आप कैप्टिव पोर्टल चलाते हैं तो मेहमान को उसे पूरा करना ही होगा। कार्ड पर यह लिखें, वरना आप उन लोगों से सपोर्ट कॉल पैदा करेंगे जो समझेंगे कि कोड फेल हो गया।

व्यावहारिक उपाय: कोड के साथ SSID और पासवर्ड पढ़ने लायक मतन में प्रिंट करें। इसकी कोई लागत नहीं, और यह उन थोड़े मेहमानों के लिए पूरी विफलता को हल्की असुविधा में बदल देता है जिनका डिवाइस कोड इस्तेमाल नहीं कर सकता।

एक Wi-Fi QR कोड में आपका नेटवर्क पासवर्ड प्रिंटेड पैटर्न के अंदर सादे मतन में होता है। जो भी स्कैन करे उसके पास पासवर्ड है। जो भी उसकी तस्वीर ले उसके पास पासवर्ड है, स्थायी रूप से, जब तक आप नेटवर्क पासवर्ड खुद न बदलें।

यह कोई खामी नहीं जिसे इंजीनियरिंग से हटाया जा सके — यह फॉर्मेट है ही ऐसा। बड़े पैमाने पर तैनाती के लिए इसके तीन सीधे नतीजे हैं:

• बदलना और दोबारा प्रिंट करना साथ चलता है। कोई भी पासवर्ड बदलने की नीति का मतलब है हर प्रभावित कोड दोबारा बनाना और प्रिंट करना। नीति पर प्रतिबद्ध होने से पहले वह लागत उसमें जोड़ें, खासकर एक 200 कमरों वाले होटल के लिए।
• गेस्ट नेटवर्क अलग रखें। कोड में गेस्ट-नेटवर्क के क्रेडेंशियल होने चाहिए, कभी आपके संचालन या पॉइंट-ऑफ-सेल नेटवर्क के नहीं। यह बुनियादी विभाजन है और कोड जितना ज़्यादा व्यापक रूप से दिखे, उतना ज़्यादा मायने रखता है।
• एक Wi-Fi QR कभी डायनामिक नहीं हो सकता। क्योंकि क्रेडेंशियल रीडायरेक्ट के पीछे नहीं, पैटर्न में हैं, इसे दूर से अपडेट करने का कोई तरीका नहीं। यह अकेला QR इस्तेमाल है जहां दोबारा प्रिंट की समस्या वाकई एक डायनामिक कोड से हल नहीं हो सकती — हमारी Wi-Fi QR कोड गाइड इसका प्लेसमेंट पक्ष बताती है।

एक होटल के लिए, काम करने वाला तरीका है एक स्थिर गेस्ट SSID जिसका पासवर्ड एक ऐसी नियोजित समय-सारणी पर बदले जो उस वक्त से मेल खाए जब कमरे की सामग्री वैसे भी दोबारा प्रिंट होती है।

Wi-Fi पेलोड आमतौर पर 40–80 अक्षरों के होते हैं, जो बड़े, आसानी से स्कैन होने वाले मॉड्यूल के साथ एक कम QR वर्ज़न में आराम से बैठते हैं। दो चीज़ें इसे बेवजह फुलाती हैं:

• लंबे जेनरेट किए पासवर्ड। एक 32-अक्षर का रैंडम ISP पासवर्ड एक 12-अक्षर के याद रखने लायक पासवर्ड के मुकाबले पेलोड लगभग दोगुना कर देता है, जिससे कोड छोटे मॉड्यूल वाले ऊंचे वर्ज़न पर चला जाता है — और यह उन्हीं पुराने कैमरों के लिए बुरा है जो पहले ही जूझने की सबसे ज़्यादा आशंका में हैं।
• एस्केप किए विशेष अक्षर। हर एस्केप एक बैकस्लैश जोड़ता है, तो ; और : से भरा पासवर्ड अपनी दिखने वाली लंबाई से ज़्यादा पेलोड लेता है।

खासकर एक गेस्ट नेटवर्क के लिए, बिना विशेष अक्षरों वाला एक याद रखने लायक 10–14 अक्षर का पासवर्ड आमतौर पर बेहतर इंजीनियरिंग चुनाव है: छोटा पेलोड, विरल कोड, बेहतर स्कैन दर, और फॉलबैक मतन के रूप में प्रिंट होने पर पढ़ने लायक। हमारी डेटा कैपेसिटी गाइड वर्ज़न-से-कैपेसिटी का रिश्ता विस्तार से बताती है।

डैशबोर्ड में, Wi-Fi एक QR टाइप है जो Starter प्लान (₹499/माह) से उपलब्ध है। आप SSID, पासवर्ड, सुरक्षा प्रकार और छिपा-हुआ फ्लैग डालते हैं; SMLLR WIFI: पेलोड को T, S, P, H क्रम में जोड़ता है।

SMLLR REST API Wi-Fi QR कोड नहीं बना सकता — या कोई भी QR कोड। सार्वजनिक API सिर्फ पढ़ने वाली रिपोर्टिंग है: अकाउंट सारांश, QR कोड, कैंपेन और एजेंसी क्लाइंट को कवर करते सात GET एंडपॉइंट, Premium प्लान (₹14,999/माह) पर, प्रति key प्रति मिनट 60 रिक्वेस्ट तक सीमित। Wi-Fi कोड के प्रोग्रामेटिक बल्क जेनरेशन के लिए, ऊपर दिखाए अनुसार अपने बैकएंड में एक QR लाइब्रेरी इस्तेमाल करें।

इस टाइप के लिए एक और ईमानदार बात: क्योंकि एक Wi-Fi कोड URL के बजाय कच्चा कॉन्फ़िगरेशन एनकोड करता है, यह बिल्कुल भी स्कैन एनालिटिक्स नहीं देता। जब एक मेहमान आपके नेटवर्क से जुड़ता है तो कुछ भी SMLLR के सर्वर को नहीं छूता। अगर आप जानना चाहते हैं कि कितने मेहमानों ने Wi-Fi इस्तेमाल किया, तो वह डेटा आपके राउटर या एक्सेस-पॉइंट प्रबंधन सिस्टम में रहता है, किसी QR डैशबोर्ड में नहीं।

SMLLR पर Wi-Fi टाइप के साथ अपना QR कोड बनाएं, और उसके साथ क्रेडेंशियल फॉलबैक मतन के रूप में प्रिंट करें।