SmartWeb

1. Gambaran Keseluruhan

SmartWeb ialah aplikasi pelayan jambatan setempat yang berjalan pada peranti Android.

Tujuan utamanya adalah seperti berikut:

- Ia menyemak status pengesahan SmartThings dan membantu dengan panggilan API yang berkaitan.

- Ia menyediakan fungsi proksi HTTP umum.

- Ia membolehkan anda membuka halaman dalam WebView (pelayar) sebenar untuk membaca HTML akhir.

- Ia bertindak sebagai perantara untuk pemacu SmartThings Edge, halaman web setempat dan skrip automasi.

2. Maklumat Asas

- Port Lalai: 8088

- Format Alamat Lalai: http://deviceIP:8088

Contoh:

- http://192.168.219.137:8088

3. Susun Atur Skrin

3.1 Tab Pelayan

Dalam Tab Pelayan, anda boleh menyemak status pelayan jambatan dan cara menggunakan API utama.

Contoh kandungan yang dipaparkan:

- Alamat pelayan jambatan

- Format penggunaan /api/forward

- Format penggunaan /api/web

- API semakan status pengesahan SmartThings

- API pelaksanaan WebView Latar Belakang

3.2 Tab Tetapan

Dalam tab Tetapan, anda boleh menyemak tetapan dan status persekitaran yang diperlukan untuk menggunakan aplikasi.

Contoh:

- Status pengecualian pengoptimuman bateri

- Status kebenaran pemberitahuan

- Lihat/salin log

- Maklumat versi aplikasi

4. API Utama

4.1 POST /api/ping

Penerangan: Menyemak status pelayan jambatan dan status pengesahan SmartThings secara ringkas.

Kaedah:

- POST sahaja

Contoh:

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

Contoh respons:

{

"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

Penerangan:

Mengembalikan senarai peranti SmartThings dalam format mudah.

Kaedah:

- GET sahaja

Contoh:

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

Contoh respons:

{

"items": [

{

"deviceId": "...",

"label": "Perpustakaan Mini Google Home",

"name": "Google Home"

}

]

}

Kegunaan:

- Apabila mencari deviceId mengikut nama peranti

- Mencari nama pembesar suara

- Memilih peranti berdasarkan label

4.3 GET /api/forward?url=origin_address

Keterangan:

Proksi HTTP standard.

Kaedah:

- GET sahaja

Contoh:

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

Kegunaan:

- Panggilan API JSON

- Membaca halaman HTML statik

- Panggilan API REST SmartThings

Ciri-ciri:

- Lulus kebanyakan pengepala permintaan

- Menggunakan kelayakan secara automatik jika pengepala Kebenaran tiada semasa memanggil API SmartThings

- Tidak melaksanakan JavaScript

- Mungkin lemah terhadap halaman pengesahan Cloudflare/pelayar

Awas:

- Tidak sesuai untuk tapak yang memerlukan pelaksanaan JavaScript

4.4 GET atau POST /api/web?url=origin_address

Penerangan: Membuka halaman dalam WebView sebenar dan mengembalikan HTML akhir.

Kaedah:

- GET atau POST

Penggunaan:

- Laman web yang memerlukan pelaksanaan JavaScript

- Halaman pengesahan Cloudflare

- Laman web tidak dimuatkan melalui /api/forward

Contoh:

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

Atau:

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

Jenis-Kandungan: application/json

{

"url": "https://",

"timeoutMs": 20000

}

Tindak Balas:

- Isi HTML akhir (teks/html) apabila berjaya

- Rentetan ralat apabila gagal

Ciri-ciri:

- Membuka halaman seperti pelayar sebenar

- Pelaksanaan JavaScript mungkin

- Perlahan tetapi mantap

Parameter Tamat Masa:

- tamat masa: saat

- tamat masaSekon: saat

- tamat masaMs: milisaat

Contoh:

- ?timeout=20

- ?timeoutSeconds=20

- ?timeoutMs=20000

Nota:

- Respons adalah badan HTML itu sendiri, bukan JSON.

- Pemanggil perlu menghuraikan HTML untuk mendapatkan nilai yang diperlukan.

4.5 GET atau POST /api/webview/run

Penerangan:

Menjalankan halaman dalam WebView latar belakang untuk tempoh masa yang ditetapkan.

Kaedah:

- GET atau POST

Kegunaan:

- Pastikan halaman tertentu berjalan di latar belakang untuk tempoh masa yang ditetapkan.

- Pastikan operasi/pelaksanaan halaman JS berjalan.

Contoh:

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

Ciri-ciri:

- Menjalankan sehingga 5 halaman secara serentak.

- Permintaan berlebihan disimpan dalam barisan.

4.6 GET /api/webview/stop

Keterangan:

Menghentikan pelaksanaan WebView latar belakang.

Kaedah:

- Pada masa ini digunakan sebagai GET

5. Perbezaan antara /api/forward dan /api/web

/api/forward

- Proksi HTTP standard

- Pantas

- Sesuai untuk panggilan JSON/API

- Tidak melaksanakan JavaScript

- Sesuai untuk halaman statik/API umum

/api/web

- Bacaan pelayar berasaskan WebView

- Perlahan tetapi mantap

- Boleh laksana JavaScript

- Menyokong halaman pengesahan Cloudflare/pelayar

- Sesuai untuk halaman yang memerlukan pelayar

Kriteria yang Disyorkan:

- API Umum/Halaman statik: /api/forward

- Halaman yang perlu dibuka dalam pelayar: /api/web

6. Ringkasan Kaedah yang Dibenarkan

POST sahaja

- /api/ping

- /api/smartthings/token

- /api/smartthings/access-token

GET sahaja

- /api/smartthings/devices

- /api/forward

GET atau POST

- /api/web

- /api/webview/run

Untuk menghentikan

- /api/webview/stop

7. Penjelasan Nilai bridgeDevice

BridgeDevice untuk /api/ping adalah salah satu daripada yang berikut:

- tv

- pad

- phone

Kriteria Penentuan:

- tv: Android TV / Peranti Leanback

- pad: smallestScreenWidthDp >= 600

- phone: Lain-lain

8. Contoh Penggunaan

8.1 Semak Status Pelayan

POST /api/ping

8.2 Semak Senarai Peranti

GET /api/smartthings/devices

8.3 Proksi API Umum

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

8.4 Baca Tapak Memerlukan Pelayar

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

9. Ringkasan

SmartWeb ialah pelayan jambatan setempat yang berjalan pada peranti Android.

Perkara Utama:

- Semak status pengesahan SmartThings

- API senarai peranti mudah

- Proksi HTTP standard (/api/forward)

- Bacaan pelayar berasaskan WebView (/api/web)

- Jalankan WebView di latar belakang (/api/webview/run)

Khususnya, fungsi /api/web membolehkan anda membaca halaman yang sukar dibaca melalui permintaan HTTP standard menggunakan kaedah pelayar sebenar.