SmartWeb

1. ภาพรวม

SmartWeb เป็นแอปพลิเคชันเซิร์ฟเวอร์บริดจ์ภายในเครื่องที่ทำงานบนอุปกรณ์ Android

วัตถุประสงค์หลักมีดังนี้:

- ตรวจสอบสถานะการตรวจสอบสิทธิ์ของ SmartThings และช่วยในการเรียกใช้ API ที่เกี่ยวข้อง

- ให้ฟังก์ชันพร็อกซี HTTP ทั่วไป

- ช่วยให้คุณเปิดหน้าเว็บใน WebView (เบราว์เซอร์) เพื่ออ่าน HTML สุดท้าย

- ทำหน้าที่เป็นตัวกลางสำหรับไดรเวอร์ SmartThings Edge หน้าเว็บภายในเครื่อง และสคริปต์อัตโนมัติ

2. ข้อมูลพื้นฐาน

- พอร์ตเริ่มต้น: 8088

- รูปแบบที่อยู่เริ่มต้น: http://deviceIP:8088

ตัวอย่าง:

- http://192.168.219.137:8088

3. โครงสร้างหน้าจอ

3.1 แท็บเซิร์ฟเวอร์

ในแท็บเซิร์ฟเวอร์ คุณสามารถตรวจสอบสถานะของเซิร์ฟเวอร์บริดจ์และวิธีการใช้ API ที่สำคัญได้

ตัวอย่างเนื้อหาที่แสดง:

- ที่อยู่เซิร์ฟเวอร์บริดจ์

- รูปแบบการใช้งาน /api/forward

- รูปแบบการใช้งาน /api/web

- API ตรวจสอบสถานะการรับรองความถูกต้องของ SmartThings

- API สำหรับการเรียกใช้ WebView ในพื้นหลัง

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"

}

]

}

การใช้งาน:

- เมื่อค้นหา deviceId โดยใช้ชื่ออุปกรณ์

- ค้นหาชื่อลำโพง

- เลือกอุปกรณ์ตามป้ายกำกับ

4.3 GET /api/forward?url=origin_address

คำอธิบาย:

พร็อกซี HTTP มาตรฐาน

วิธีการ:

- GET เท่านั้น

ตัวอย่าง:

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

การใช้งาน:

- การเรียกใช้ API ในรูปแบบ JSON

- การอ่านหน้า HTML แบบคงที่

- การเรียกใช้ SmartThings REST API

คุณสมบัติ:

- ส่งผ่านส่วนหัวคำขอส่วนใหญ่

- ใช้ข้อมูลรับรองโดยอัตโนมัติหากไม่มีส่วนหัว Authorization เมื่อเรียกใช้ SmartThings API

- ไม่เรียกใช้ JavaScript

- อาจอ่อนแอต่อการตรวจสอบความถูกต้องของ Cloudflare/เบราว์เซอร์

ข้อควรระวัง:

- ไม่เหมาะสำหรับเว็บไซต์ที่ต้องการการเรียกใช้ JavaScript

4.4 GET หรือ POST /api/web?url=origin_address

คำอธิบาย: เปิดหน้าเว็บใน WebView จริงและส่งคืน HTML สุดท้าย

วิธีการ:

- GET หรือ POST

การใช้งาน:

- เว็บไซต์ที่ต้องการการเรียกใช้ JavaScript

- หน้าตรวจสอบความถูกต้องของ Cloudflare

- เว็บไซต์ที่ไม่ได้โหลดผ่าน /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) เมื่อสำเร็จ

- ข้อความแสดงข้อผิดพลาดเมื่อล้มเหลว

คุณสมบัติ:

- เปิดหน้าเว็บเหมือนเบราว์เซอร์จริง

- สามารถเรียกใช้ JavaScript ได้

- ช้าแต่เสถียร

พารามิเตอร์การหมดเวลา:

- timeout: วินาที

- timeoutSeconds: วินาที

- timeoutMs: มิลลิวินาที

ตัวอย่าง:

- ?timeout=20

- ?timeoutSeconds=20

- ?timeoutMs=20000

หมายเหตุ:

- การตอบกลับคือเนื้อหา HTML ไม่ใช่ JSON

- ผู้เรียกต้องแยกวิเคราะห์ HTML เพื่อรับค่าที่จำเป็น

4.5 GET หรือ POST /api/webview/run

คำอธิบาย:

เรียกใช้งานหน้าเว็บใน WebView พื้นหลังเป็นระยะเวลาที่กำหนด

วิธีการ:

- GET หรือ POST

การใช้งาน:

- เรียกใช้งานหน้าเว็บเฉพาะในพื้นหลังเป็นระยะเวลาที่กำหนด

- เรียกใช้งานการทำงานของ JS/หน้าเว็บ

ตัวอย่าง:

GET 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/forward

- พร็อกซี HTTP มาตรฐาน

- เร็ว

- เหมาะสำหรับการเรียกใช้ JSON/API

- ไม่เรียกใช้ JavaScript

- เหมาะสำหรับหน้าเว็บแบบคงที่/API ทั่วไป

/api/web

- อ่านผ่านเบราว์เซอร์โดยใช้ WebView

- ช้าแต่เสถียร

- สามารถเรียกใช้ JavaScript ได้

- รองรับหน้าเว็บที่ตรวจสอบความถูกต้องโดย Cloudflare/เบราว์เซอร์

- เหมาะสำหรับหน้าเว็บที่ต้องใช้เบราว์เซอร์

เกณฑ์ที่แนะนำ:

- 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

bridgeDevice สำหรับ /api/ping คือหนึ่งในค่าต่อไปนี้:

- tv

- pad

- phone

เกณฑ์การพิจารณา:

- tv: อุปกรณ์ Android TV / Leanback

- pad: smallestScreenWidthDp >= 600

- phone: อื่นๆ

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. สรุป

SmartWeb คือเซิร์ฟเวอร์บริดจ์ภายในเครื่องที่ทำงานอยู่บน อุปกรณ์ Android

ประเด็นสำคัญ:

- ตรวจสอบสถานะการรับรองความถูกต้องของ SmartThings

- API แสดงรายการอุปกรณ์อย่างง่าย

- พร็อกซี HTTP มาตรฐาน (/api/forward)

- การอ่านเบราว์เซอร์โดยใช้ WebView (/api/web)

- เรียกใช้ WebView ในพื้นหลัง (/api/webview/run)

โดยเฉพาะอย่างยิ่ง ฟังก์ชัน /api/web ช่วยให้คุณอ่านหน้าเว็บที่ยากต่อการอ่านผ่านคำขอ HTTP มาตรฐานโดยใช้วิธีการของเบราว์เซอร์จริง