SmartThings Web Host

1. جائزہ

SmartWeb ایک مقامی برج سرور ایپ ہے جو Android آلات پر چلتی ہے۔

اس کے بنیادی مقاصد درج ذیل ہیں:

- یہ SmartThings کی توثیق کی حیثیت کو چیک کرتا ہے اور متعلقہ API کالوں میں مدد کرتا ہے۔

- یہ عام HTTP پراکسی فعالیت فراہم کرتا ہے۔

- یہ آپ کو حتمی HTML پڑھنے کے لیے ایک حقیقی ویب ویو (براؤزر) میں صفحہ کھولنے کی اجازت دیتا ہے۔

- یہ SmartThings Edge ڈرائیوروں، مقامی ویب صفحات، اور آٹومیشن اسکرپٹس کے لیے ایک ثالث کے طور پر کام کرتا ہے۔

2. بنیادی معلومات

- ڈیفالٹ پورٹ: 8088

- ڈیفالٹ ایڈریس فارمیٹ: http://deviceIP:8088

مثال:

- http://192.168.219.137:8088

3. سکرین لے آؤٹ

3.1 سرور ٹیب

سرور ٹیب میں، آپ برج سرور کی حیثیت اور کلیدی APIs کو استعمال کرنے کا طریقہ چیک کر سکتے ہیں۔

ظاہر کردہ مواد کی مثالیں:

- برج سرور کا پتہ

- /api/فارورڈ استعمال کی شکل

- /api/ویب کے استعمال کی شکل

- SmartThings کی توثیق کی حیثیت چیک API

- بیک گراؤنڈ ویب ویو ایگزیکیوشن API

3.2 ترتیبات کا ٹیب

ترتیبات کے ٹیب میں، آپ ایپ کو استعمال کرنے کے لیے درکار ماحول کی ترتیبات اور اسٹیٹس چیک کر سکتے ہیں۔

مثالیں:

- بیٹری کی اصلاح کی استثناء کی حیثیت

- اطلاع کی اجازت کی حیثیت

- لاگز دیکھیں / کاپی کریں۔

- ایپ ورژن کی معلومات

4. کلیدی APIs

4.1 پوسٹ /api/ping

تفصیل: برج سرور کی حیثیت اور SmartThings کی توثیق کی حیثیت کو مختصراً چیک کرتا ہے۔

طریقہ:

- صرف پوسٹ کریں۔

مثال:

پوسٹ http://deviceIP:8088/api/ping

مثال کے جواب:

{

"بیٹری": 86،

"bridgeDevice": "فون",

"bridgeVersion": "ورژن: 2026.05.15",

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

"stOauthConnected": سچ،

"accessTokenExpiresAt": 1778773965000،

"accessTokenMinutesLeft": 1332

}

4.2 /api/smartthings/devices حاصل کریں۔

تفصیل:

ایک سادہ فارمیٹ میں SmartThings آلات کی فہرست لوٹاتا ہے۔

طریقہ:

- صرف حاصل کریں۔

مثال:

http://deviceIP:8088/api/smartthings/devices حاصل کریں۔

مثال کے جواب:

{

"آئٹمز": [

{

"deviceId": "...",

"label": "گوگل ہوم منی لائبریری",

"name": "گوگل ہوم"

}

]

}

استعمال کرتا ہے:

- ڈیوائس کے نام سے ڈیوائس آئی ڈی تلاش کرتے وقت

- اسپیکر کے ناموں کی تلاش

- لیبل کی بنیاد پر آلات کا انتخاب

4.3 /api/forward?url=origin_address حاصل کریں۔

تفصیل:

ایک معیاری HTTP پراکسی۔

طریقہ:

- صرف حاصل کریں۔

مثال:

http://deviceIP:8088/api/forward?url=https://api.smartthings.com/v1/devices حاصل کریں

استعمال کرتا ہے:

- JSON API کالز

- جامد HTML صفحات پڑھنا

- SmartThings REST API کالز

خصوصیات:

- زیادہ تر درخواست کے ہیڈر پاس کرتا ہے۔

- اگر SmartThings APIs کو کال کرتے وقت اجازت کا ہیڈر غائب ہو تو خودکار طور پر اسناد کا استعمال کرتا ہے۔

- جاوا اسکرپٹ پر عمل نہیں کرتا ہے۔

- Cloudflare/براؤزر کی توثیق کے صفحات کے خلاف کمزور ہوسکتا ہے۔

احتیاط:

- ان سائٹس کے لیے موزوں نہیں جنہیں JavaScript پر عمل درآمد کی ضرورت ہوتی ہے۔

4.4 حاصل کریں یا پوسٹ کریں /api/web?url=origin_address

تفصیل: صفحہ کو ایک حقیقی WebView میں کھولتا ہے اور حتمی HTML لوٹاتا ہے۔

طریقہ:

- حاصل کریں یا پوسٹ کریں۔

استعمال:

- سائٹس کو جاوا اسکرپٹ پر عمل درآمد کی ضرورت ہوتی ہے۔

- Cloudflare کی توثیق کے صفحات

- سائٹس /api/forward کے ذریعے لوڈ نہیں ہوتی ہیں۔

مثال:

http://deviceIP:8088/api/web?url=https:// حاصل کریں

یا:

پوسٹ http://deviceIP:8088/api/web

مواد کی قسم: درخواست/json

{

"url": "https://",

"ٹائم آؤٹ ایم ایس": 20000

}

جواب:

- کامیابی پر حتمی HTML باڈی (متن/HTML)

- ناکامی پر غلطی کی تار

خصوصیات:

- ایک حقیقی براؤزر کی طرح صفحہ کھولتا ہے۔

- جاوا اسکرپٹ پر عمل درآمد ممکن ہے۔

- آہستہ لیکن مضبوط

ٹائم آؤٹ پیرامیٹرز:

- ٹائم آؤٹ: سیکنڈ

- ٹائم آؤٹ سیکنڈ: سیکنڈ

- ٹائم آؤٹ ایمز: ملی سیکنڈ

مثال:

- ٹائم آؤٹ = 20

- ٹائم آؤٹ سیکنڈز = 20

- ?timeoutMs=20000

نوٹ:

- جواب خود HTML باڈی ہے، JSON نہیں۔

- کال کرنے والے کو ضروری اقدار حاصل کرنے کے لیے HTML کو پارس کرنے کی ضرورت ہے۔

4.5 حاصل کریں یا پوسٹ کریں /api/webview/run

تفصیل:

ایک صفحہ کو ایک مقررہ مدت کے لیے پس منظر میں WebView چلاتا ہے۔

طریقہ:

- حاصل کریں یا پوسٹ کریں۔

استعمال کرتا ہے:

- ایک مخصوص صفحہ کو ایک مقررہ مدت کے لیے پس منظر میں چلاتے رہیں۔

- جے ایس آپریشنز/صفحہ پر عملدرآمد جاری رکھیں۔

مثال:

حاصل کریں http://deviceIP:8088/api/webview/run?url=http://hubaddress:port&timeout=60

خصوصیات:

- بیک وقت 5 صفحات تک چلتا ہے۔

- اضافی درخواستوں کو قطار میں محفوظ کیا جاتا ہے۔

4.6 GET /api/webview/stop

تفصیل:

پس منظر WebView کے عمل کو روکتا ہے۔

طریقہ:

- فی الحال GET کے طور پر استعمال کیا جاتا ہے۔

5. /api/forward اور /api/web کے درمیان فرق

/api/فارورڈ

- معیاری HTTP پراکسی

--.تیز

- JSON/API کالز کے لیے موزوں

- جاوا اسکرپٹ پر عمل نہیں کرتا ہے۔

- جامد صفحات/جنرل APIs کے لیے موزوں

/api/web

- ویب ویو پر مبنی براؤزر پڑھیں

- آہستہ لیکن مضبوط

- جاوا اسکرپٹ قابل عمل ہے۔

- Cloudflare / براؤزر کی توثیق والے صفحات کی حمایت کرتا ہے۔

- براؤزر کی ضرورت والے صفحات کے لیے موزوں

تجویز کردہ معیار:

- عمومی APIs/جامد صفحات: /api/forward

- وہ صفحات جنہیں براؤزر میں کھولنے کی ضرورت ہے: /api/web

6. اجازت شدہ طریقوں کا خلاصہ

صرف پوسٹ کریں۔

- /api/ping

- /api/smartthings/token

- /api/smartthings/access-token

صرف حاصل کریں۔

- /api/smartthings/devices

- /api/forward

حاصل کریں یا پوسٹ کریں۔

- /api/web

- /api/webview/run

روکنے کے لیے

- /api/webview/stop

7. برج ڈیوائس ویلیو کی وضاحت

/api/ping کے لیے bridgeDevice درج ذیل میں سے ایک ہے:

--.ٹی وی

--.پیڈ

--.فون

تعین کا معیار:

- tv: Android TV / Leanback آلات

- پیڈ: چھوٹی اسکرین کی چوڑائی>= 600

- فون: دیگر

8. استعمال کی مثالیں۔

8.1 سرور کی حیثیت چیک کریں۔

پوسٹ /api/ping

8.2 ڈیوائس کی فہرست چیک کریں۔

/api/smartthings/devices حاصل کریں۔

8.3 جنرل API پراکسی

/api/forward?url=https://api.smartthings.com/v1/devices حاصل کریں

8.4 پڑھیں سائٹس کو براؤزر کی ضرورت ہے۔

/api/web?url=https:// حاصل کریں۔

9. خلاصہ

اسمارٹ ویب ایک مقامی برج سرور ہے جو اینڈرائیڈ ڈیوائسز پر چل رہا ہے۔

اہم نکات:

- SmartThings کی توثیق کی حیثیت کو چیک کریں۔

- سادہ ڈیوائس لسٹ API

- معیاری HTTP پراکسی (/api/فارورڈ)

- ویب ویو پر مبنی براؤزر ریڈنگ (/api/web)

- پس منظر میں ویب ویو چلائیں (/api/webview/run)

خاص طور پر، /api/web فنکشن آپ کو ان صفحات کو پڑھنے کی اجازت دیتا ہے جنہیں معیاری HTTP درخواستوں کے ذریعے حقیقی براؤزر کا طریقہ استعمال کرتے ہوئے پڑھنا مشکل ہے۔