SmartWeb

1. अवलोकन

स्मार्टवेब एक स्थानीय ब्रिज सर्वर ऐप है जो एंड्रॉइड डिवाइस पर चलता है।

इसके मुख्य उद्देश्य निम्नलिखित हैं:

- यह स्मार्टथिंग्स प्रमाणीकरण स्थिति की जाँच करता है और संबंधित API कॉल में सहायता करता है।

- यह सामान्य HTTP प्रॉक्सी कार्यक्षमता प्रदान करता है।

- यह आपको अंतिम HTML पढ़ने के लिए किसी पृष्ठ को वास्तविक वेबव्यू (ब्राउज़र) में खोलने की अनुमति देता है।

- यह स्मार्टथिंग्स एज ड्राइवर, स्थानीय वेब पेज और स्वचालन स्क्रिप्ट के लिए मध्यस्थ के रूप में कार्य करता है।

2. बुनियादी जानकारी

- डिफ़ॉल्ट पोर्ट: 8088

- डिफ़ॉल्ट पता प्रारूप: http://deviceIP:8088

उदाहरण:

- http://192.168.219.137:8088

3. स्क्रीन लेआउट

3.1 सर्वर टैब

सर्वर टैब में, आप ब्रिज सर्वर की स्थिति और प्रमुख API का उपयोग करने का तरीका देख सकते हैं।

प्रदर्शित सामग्री के उदाहरण:

- ब्रिज सर्वर पता

- /api/forward उपयोग प्रारूप

- /api/web उपयोग प्रारूप

- SmartThings प्रमाणीकरण स्थिति जांच API

- बैकग्राउंड वेबव्यू निष्पादन API

3.2 सेटिंग्स टैब

सेटिंग्स टैब में, आप ऐप का उपयोग करने के लिए आवश्यक परिवेश सेटिंग्स और स्थिति की जांच कर सकते हैं।

उदाहरण:

- बैटरी अनुकूलन अपवाद स्थिति

- अधिसूचना अनुमति स्थिति

- लॉग देखें/कॉपी करें

- ऐप संस्करण जानकारी

4. मुख्य API

4.1 POST /api/ping

विवरण: ब्रिज सर्वर स्थिति और SmartThings प्रमाणीकरण स्थिति की संक्षिप्त जांच करता है।

विधि:

- केवल POST अनुरोध

उदाहरण:

POST http://deviceIP:8088/api/ping

उदाहरण प्रतिक्रिया:

{

"battery": 86,

"bridgeDevice": "phone",

"bridgeVersion": "Version: 2026.05.15",

"serverStartTime": "05/14 03:00",

"stOauthConnected": true,

"accessTokenExpiresAt": 1778773965000,

"accessTokenMinutesLeft": 1332

}

4.2 GET /api/smartthings/devices

विवरण:

SmartThings उपकरणों की एक सरल प्रारूप में सूची लौटाता है।

विधि:

- केवल GET

उदाहरण:

GET http://deviceIP:8088/api/smartthings/devices

उदाहरण प्रतिक्रिया:

{

"items": [

{

"deviceId": "...",

"label": "Google Home Mini Library",

"name": "Google Home"

}

]

}

उपयोग:

- डिवाइस के नाम से डिवाइस आईडी ढूंढना

- स्पीकर के नाम खोजना

- लेबल के आधार पर डिवाइस चुनना

4.3 GET /api/forward?url=origin_address

विवरण:

एक मानक HTTP प्रॉक्सी।

विधि:

- केवल GET अनुरोध

उदाहरण:

GET http://deviceIP:8088/api/forward?url=https://api.smartthings.com/v1/devices

उपयोग:

- JSON API कॉल

- स्थिर HTML पृष्ठ पढ़ना

- SmartThings REST API कॉल

विशेषताएं:

- अधिकांश अनुरोध हेडर पास करता है

- SmartThings API कॉल करते समय यदि Authorization हेडर अनुपस्थित हो तो क्रेडेंशियल का स्वचालित रूप से उपयोग करता है

- जावास्क्रिप्ट निष्पादित नहीं करता

- Cloudflare/ब्राउज़र सत्यापन पृष्ठों के विरुद्ध कमज़ोर हो सकता है

सावधानी:

- जावास्क्रिप्ट निष्पादन की आवश्यकता वाली साइटों के लिए उपयुक्त नहीं है

4.4 GET या POST /api/web?url=origin_address

विवरण: पृष्ठ को वास्तविक WebView में खोलता है और अंतिम HTML लौटाता है।

विधि:

- GET या POST

उपयोग:

- जावास्क्रिप्ट निष्पादन की आवश्यकता वाली साइटें

- क्लाउडफ्लेयर सत्यापन पृष्ठ

- /api/forward के माध्यम से लोड नहीं होने वाली साइटें

उदाहरण:

GET http://deviceIP:8088/api/web?url=https://

या:

POST http://deviceIP:8088/api/web

Content-Type: application/json

{

"url": "https://",

"timeoutMs": 20000

}

प्रतिक्रिया:

- सफलता पर अंतिम HTML बॉडी (text/html)

- विफलता पर त्रुटि स्ट्रिंग

विशेषताएं:

- पृष्ठ को वास्तविक ब्राउज़र की तरह खोलता है

- जावास्क्रिप्ट निष्पादन संभव

- धीमा लेकिन मजबूत

टाइमआउट पैरामीटर:

- timeout: सेकंड

- timeoutSeconds: सेकंड

- timeoutMs: मिलीसेकंड

उदाहरण:

- ?timeout=20

- ?timeoutSeconds=20

- ?timeoutMs=20000

नोट:

- प्रतिक्रिया HTML बॉडी है, JSON नहीं।

- कॉलर को आवश्यक मान प्राप्त करने के लिए HTML को पार्स करना होगा।

4.5 GET या POST /api/webview/run

विवरण:

किसी पृष्ठ को निर्धारित समयावधि के लिए बैकग्राउंड वेबव्यू में चलाता है।

विधि:

- GET या POST

उपयोग:

- किसी विशिष्ट पृष्ठ को निर्धारित समयावधि के लिए बैकग्राउंड में चालू रखता है।

- JS ऑपरेशन/पृष्ठ निष्पादन को चालू रखता है।

उदाहरण:

GET http://deviceIP:8088/api/webview/run?url=http://hubaddress:port&timeout=60

विशेषताएं:

- एक साथ 5 पृष्ठों तक चला सकता है।

अतिरिक्त अनुरोधों को कतार में संग्रहित किया जाता है।

4.6 GET /api/webview/stop

विवरण:

बैकग्राउंड वेबव्यू के निष्पादन को रोकता है।

विधि:

- वर्तमान में GET के रूप में उपयोग किया जाता है

5. /api/forward और /api/web के बीच अंतर

/api/forward

- मानक HTTP प्रॉक्सी

- तेज़

- JSON/API कॉल के लिए उपयुक्त

- जावास्क्रिप्ट निष्पादित नहीं करता

- स्थिर पृष्ठों/सामान्य API के लिए उपयुक्त

/api/web

- वेबव्यू-आधारित ब्राउज़र रीड

- धीमा लेकिन मज़बूत

- जावास्क्रिप्ट निष्पादन योग्य

- क्लाउडफ्लेयर/ब्राउज़र सत्यापन पृष्ठों का समर्थन करता है

- ब्राउज़र की आवश्यकता वाले पृष्ठों के लिए उपयुक्त

अनुशंसित मानदंड:

- सामान्य API/स्थिर पृष्ठ: /api/forward

- ब्राउज़र में खोले जाने वाले पृष्ठ: /api/web

6. अनुमत विधियों का सारांश

केवल POST

- /api/ping

- /api/smartthings/token

- /api/smartthings/access-token

केवल GET

- /api/smartthings/devices

- /api/forward

GET या POST

- /api/web

- /api/webview/run

रोकने के लिए

- /api/webview/stop

7. bridgeDevice मान की व्याख्या

/api/ping के लिए bridgeDevice निम्न में से एक है:

- टीवी

- पैड

- फ़ोन

निर्धारण मानदंड:

- टीवी: एंड्रॉइड टीवी / लीनबैक डिवाइस

- पैड: smallestScreenWidthDp >= 600

- फ़ोन: अन्य

8. उपयोग के उदाहरण

8.1 सर्वर स्थिति जांचें

POST /api/ping

8.2 डिवाइस सूची जांचें

GET /api/smartthings/devices

8.3 सामान्य API प्रॉक्सी

GET /api/forward?url=https://api.smartthings.com/v1/devices

8.4 ब्राउज़र की आवश्यकता वाली साइटें पढ़ें

GET /api/web?url=https://

9. सारांश

स्मार्टवेब एंड्रॉइड डिवाइसों पर चलने वाला एक स्थानीय ब्रिज सर्वर है।

मुख्य बिंदु:

- स्मार्टथिंग्स प्रमाणीकरण स्थिति की जाँच करें

- सरल डिवाइस सूची एपीआई

- मानक HTTP प्रॉक्सी (/api/forward)

- वेबव्यू-आधारित ब्राउज़र पठन (/api/web)

- पृष्ठभूमि में वेबव्यू चलाएँ (/api/webview/run)

विशेष रूप से, /api/web फ़ंक्शन आपको उन पृष्ठों को पढ़ने की अनुमति देता है जिन्हें मानक HTTP अनुरोधों के माध्यम से पढ़ना मुश्किल होता है, एक वास्तविक ब्राउज़र विधि का उपयोग करके।