SmartThings Web Host

1. Gambaran Umum

SmartWeb adalah aplikasi server jembatan lokal yang berjalan di perangkat Android.

Tujuan utamanya adalah sebagai berikut:

- Memeriksa status otentikasi SmartThings dan membantu panggilan API terkait.

- Menyediakan fungsionalitas proxy HTTP umum.

- Memungkinkan Anda membuka halaman di WebView (browser) untuk membaca HTML akhir.

- Bertindak sebagai perantara untuk driver SmartThings Edge, halaman web lokal, dan skrip otomatisasi.

2. Informasi Dasar

- Port Default: 8088

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

Contoh:

- http://192.168.219.137:8088

3. Tata Letak Layar

3.1 Tab Server

Di Tab Server, Anda dapat memeriksa status server jembatan dan cara menggunakan API utama.

Contoh konten yang ditampilkan:

- Alamat server bridge

- Format penggunaan /api/forward

- Format penggunaan /api/web

- API pengecekan status autentikasi SmartThings

- API eksekusi Background WebView

3.2 Tab Pengaturan

Di tab Pengaturan, Anda dapat memeriksa pengaturan lingkungan dan status yang diperlukan untuk menggunakan aplikasi.

Contoh:

- Status pengecualian pengoptimalan baterai

- Status izin notifikasi

- Lihat/salin log

- Informasi versi aplikasi

4. API Utama

4.1 POST /api/ping

Deskripsi: Secara singkat memeriksa status server bridge dan status autentikasi SmartThings.

Metode:

- Hanya POST

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

Deskripsi:

Mengembalikan daftar perangkat SmartThings dalam format sederhana.

Metode:

- Hanya GET

Contoh:

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

Contoh respons:

{

"items": [

{

"deviceId": "...",

"label": "Google Home Mini Library",

"name": "Google Home"

}

]

}

Kegunaan:

- Saat mencari deviceId berdasarkan nama perangkat

- Mencari nama speaker

- Memilih perangkat berdasarkan label

4.3 GET /api/forward?url=origin_address

Deskripsi:

Proxy HTTP standar.

Metode:

- Hanya GET

Contoh:

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

Penggunaan:

- Panggilan API JSON

- Membaca halaman HTML statis

- Panggilan API REST SmartThings

Fitur:

- Meneruskan sebagian besar header permintaan

- Secara otomatis menggunakan kredensial jika header Otorisasi hilang saat memanggil API SmartThings

- Tidak menjalankan JavaScript

- Mungkin lemah terhadap halaman validasi Cloudflare/browser

Peringatan:

- Tidak cocok untuk situs yang memerlukan eksekusi JavaScript

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

Deskripsi: Membuka halaman di WebView sebenarnya dan mengembalikan HTML akhir.

Metode:

- GET atau POST

Penggunaan:

- Situs yang memerlukan eksekusi JavaScript

- Halaman validasi Cloudflare

- Situs yang tidak dimuat melalui /api/forward

Contoh:

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

Atau:

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

Content-Type: application/json

{

"url": "https://",

"timeoutMs": 20000

}

Respons:

- Isi HTML akhir (text/html) jika berhasil

- String kesalahan jika gagal

Fitur:

- Membuka halaman seperti browser sungguhan

- Eksekusi JavaScript dimungkinkan

- Lambat tetapi tangguh

Parameter Timeout:

- timeout: detik

- timeoutSeconds: detik

- timeoutMs: milidetik

Contoh:

- ?timeout=20

- ?timeoutSeconds=20

- ?timeoutMs=20000

Catatan:

- Responsnya adalah isi HTML itu sendiri, bukan JSON.

- Pemanggil perlu mengurai HTML untuk mendapatkan nilai yang diperlukan.

4.5 GET atau POST /api/webview/run

Deskripsi:

Menjalankan halaman di WebView latar belakang untuk jangka waktu tertentu.

Metode:

- GET atau POST

Kegunaan:

- Menjaga agar halaman tertentu tetap berjalan di latar belakang untuk jangka waktu tertentu.

- Menjaga agar operasi JS/eksekusi halaman tetap berjalan.

Contoh:

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

Fitur:

- Menjalankan hingga 5 halaman secara bersamaan.

- Permintaan berlebih disimpan dalam antrian.

4.6 GET /api/webview/stop

Deskripsi:

Menghentikan eksekusi WebView yang berjalan di latar belakang.

Metode:

- Saat ini digunakan sebagai GET

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

/api/forward

- Proxy HTTP standar

- Cepat

- Cocok untuk panggilan JSON/API

- Tidak menjalankan JavaScript

- Cocok untuk halaman statis/API umum

/api/web

- Pembacaan browser berbasis WebView

- Lambat tetapi tangguh

- Dapat menjalankan JavaScript

- Mendukung halaman validasi Cloudflare/browser

- Cocok untuk halaman yang membutuhkan browser

Kriteria yang Direkomendasikan:

- API Umum/Halaman Statis: /api/forward

- Halaman yang perlu dibuka di browser: /api/web

6. Ringkasan Metode yang Diizinkan

Hanya POST

- /api/ping

- /api/smartthings/token

- /api/smartthings/access-token

Hanya GET

- /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 dari berikut ini:

- tv

- pad

- phone

Kriteria Penentuan:

- tv: Perangkat Android TV / Leanback

- pad: smallestScreenWidthDp >= 600

- phone: Lainnya

8. Contoh Penggunaan

8.1 Memeriksa Status Server

POST /api/ping

8.2 Memeriksa Daftar Perangkat

GET /api/smartthings/devices

8.3 Proksi API Umum

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

8.4 Membaca Situs yang Membutuhkan Browser

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

9. Ringkasan

SmartWeb adalah server bridge lokal yang berjalan di perangkat Android.

Poin-Poin Penting:

- Memeriksa status otentikasi SmartThings

- API daftar perangkat sederhana

- Proxy HTTP standar (/api/forward)

- Pembacaan browser berbasis WebView (/api/web)

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

Secara khusus, fungsi /api/web memungkinkan Anda untuk membaca halaman yang sulit dibaca melalui permintaan HTTP standar menggunakan metode browser yang sebenarnya.