SmartWeb

১. সংক্ষিপ্ত বিবরণ

SmartWeb হলো একটি লোকাল ব্রিজ সার্ভার অ্যাপ যা অ্যান্ড্রয়েড ডিভাইসে চলে।

এর প্রধান উদ্দেশ্যগুলো নিম্নরূপ:

- এটি SmartThings-এর অথেনটিকেশন স্ট্যাটাস পরীক্ষা করে এবং সম্পর্কিত API কলগুলোতে সহায়তা করে।

- এটি সাধারণ HTTP প্রক্সি কার্যকারিতা প্রদান করে।

- এটি আপনাকে চূড়ান্ত HTML পড়ার জন্য একটি আসল WebView (ব্রাউজার)-এ একটি পেজ খোলার সুযোগ দেয়।

- এটি SmartThings Edge ড্রাইভার, লোকাল ওয়েব পেজ এবং অটোমেশন স্ক্রিপ্টগুলোর জন্য মধ্যস্থতাকারী হিসেবে কাজ করে।

২. প্রাথমিক তথ্য

- ডিফল্ট পোর্ট: 8088

- ডিফল্ট অ্যাড্রেস ফরম্যাট: http://deviceIP:8088

উদাহরণ:

- http://192.168.219.137:8088

৩. স্ক্রিন লেআউট

৩.১ সার্ভার ট্যাব

সার্ভার ট্যাবে, আপনি ব্রিজ সার্ভারের স্ট্যাটাস এবং মূল API-গুলো কীভাবে ব্যবহার করতে হয় তা দেখতে পারেন।

প্রদর্শিত বিষয়বস্তুর উদাহরণ:

- ব্রিজ সার্ভারের ঠিকানা

- /api/forward ব্যবহারের ফরম্যাট

- /api/web ব্যবহারের ফরম্যাট

- SmartThings অথেনটিকেশন স্ট্যাটাস চেক করার এপিআই

- ব্যাকগ্রাউন্ড ওয়েবভিউ এক্সিকিউশন এপিআই

৩.২ সেটিংস ট্যাব

সেটিংস ট্যাবে, আপনি অ্যাপটি ব্যবহারের জন্য প্রয়োজনীয় পরিবেশগত সেটিংস এবং স্ট্যাটাস চেক করতে পারেন।

উদাহরণ:

- ব্যাটারি অপটিমাইজেশন এক্সেপশন স্ট্যাটাস

- নোটিফিকেশন পারমিশন স্ট্যাটাস

- লগ দেখা/কপি করা

- অ্যাপ ভার্সনের তথ্য

৪. প্রধান এপিআইসমূহ

৪.১ 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

}

৪.২ GET /api/smartthings/devices

বিবরণ:

একটি সহজ বিন্যাসে SmartThings ডিভাইসগুলির একটি তালিকা ফেরত দেয়।

পদ্ধতি:

- শুধুমাত্র GET

উদাহরণ:

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

উদাহরণ প্রতিক্রিয়া:

{

"items": [

{

"deviceId": "...",

"label": "Google Home Mini Library",

"name": "Google Home"

}

]

ব্যবহারসমূহ:

- ডিভাইসের নাম দিয়ে deviceId খোঁজার ক্ষেত্রে

- স্পিকারের নাম অনুসন্ধান করার ক্ষেত্রে

- লেবেলের উপর ভিত্তি করে ডিভাইস নির্বাচন করার ক্ষেত্রে

৪.৩ 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/ব্রাউজার ভ্যালিডেশন পেজের ক্ষেত্রে দুর্বল হতে পারে

সতর্কতা:

- যেসব সাইটে জাভাস্ক্রিপ্ট এক্সিকিউশনের প্রয়োজন হয়, সেগুলোর জন্য উপযুক্ত নয়

৪.৪ 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 পার্স করতে হবে।

৪.৫ GET বা POST /api/webview/run

বিবরণ:

একটি নির্দিষ্ট সময়ের জন্য ব্যাকগ্রাউন্ড ওয়েবভিউতে একটি পেজ চালায়।

মেথড:

- GET বা POST

ব্যবহার:

- একটি নির্দিষ্ট পেজকে একটি নির্দিষ্ট সময়ের জন্য ব্যাকগ্রাউন্ডে চালু রাখা।

- JS অপারেশন/পেজ এক্সিকিউশন চালু রাখা।

উদাহরণ:

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

বৈশিষ্ট্য:

- একই সাথে ৫টি পর্যন্ত পেজ চালাতে পারে।

- অতিরিক্ত অনুরোধগুলো একটি কিউ-তে জমা হয়।

৪.৬ GET /api/webview/stop

বিবরণ:

একটি ব্যাকগ্রাউন্ড WebView-এর কার্যক্রম বন্ধ করে দেয়।

পদ্ধতি:

- বর্তমানে GET হিসেবে ব্যবহৃত হয়

৫. /api/forward এবং /api/web এর মধ্যে পার্থক্য

/api/forward

- স্ট্যান্ডার্ড HTTP প্রক্সি

- দ্রুত

- JSON/API কলের জন্য উপযুক্ত

- জাভাস্ক্রিপ্ট এক্সিকিউট করে না

- স্ট্যাটিক পেজ/সাধারণ API-এর জন্য উপযুক্ত

/api/web

- WebView-ভিত্তিক ব্রাউজার রিড

- ধীর কিন্তু শক্তিশালী

- জাভাস্ক্রিপ্ট এক্সিকিউটেবল

- Cloudflare/ব্রাউজার ভ্যালিডেশন পেজ সাপোর্ট করে

- ব্রাউজার প্রয়োজন এমন পেজের জন্য উপযুক্ত

সুপারিশকৃত মানদণ্ড:

- সাধারণ API/স্ট্যাটিক পেজ: /api/forward

- যে পেজগুলো ব্রাউজারে খুলতে হবে: /api/web

৬. অনুমোদিত মেথডগুলোর সারসংক্ষেপ

শুধুমাত্র POST

- /api/ping

- /api/smartthings/token

- /api/smartthings/access-token

শুধুমাত্র GET

- /api/smartthings/devices

- /api/forward

GET অথবা পোস্ট

- /api/web

- /api/webview/run

বন্ধ করার জন্য

- /api/webview/stop

৭. bridgeDevice মানের ব্যাখ্যা

/api/ping-এর জন্য bridgeDevice হলো নিম্নলিখিতগুলির মধ্যে একটি:

- tv

- pad

- phone

নির্ধারণের মানদণ্ড:

- tv: অ্যান্ড্রয়েড টিভি / লিনব্যাক ডিভাইস

- pad: smallestScreenWidthDp >= 600

- phone: অন্যান্য

৮. ব্যবহারের উদাহরণ

৮.১ সার্ভারের অবস্থা পরীক্ষা করুন

POST /api/ping

৮.২ ডিভাইসের তালিকা পরীক্ষা করুন

GET /api/smartthings/devices

৮.৩ সাধারণ এপিআই প্রক্সি

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

৮.৪ ব্রাউজার প্রয়োজন এমন সাইট পড়ুন

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

৯. সারসংক্ষেপ

SmartWeb একটি স্থানীয় ব্রিজ সার্ভার অ্যান্ড্রয়েড ডিভাইসে চলে।

মূল বৈশিষ্ট্য:

SmartThings অথেনটিকেশন স্ট্যাটাস চেক করুন

- সহজ ডিভাইস তালিকা এপিআই (API)

- স্ট্যান্ডার্ড HTTP প্রক্সি (/api/forward)

- WebView-ভিত্তিক ব্রাউজার রিডিং (/api/web)

- ব্যাকগ্রাউন্ডে WebView চালান (/api/webview/run)

বিশেষ করে, /api/web ফাংশনটি আপনাকে একটি প্রকৃত ব্রাউজার পদ্ধতি ব্যবহার করে এমন সব পেজ পড়তে দেয়, যা স্ট্যান্ডার্ড HTTP রিকোয়েস্টের মাধ্যমে পড়া কঠিন।