SmartThings Web Host

1. Genel Bakış

SmartWeb, Android cihazlarda çalışan yerel bir köprü sunucu uygulamasıdır.

Başlıca amaçları şunlardır:

- SmartThings kimlik doğrulama durumunu kontrol eder ve ilgili API çağrılarına yardımcı olur.

- Genel HTTP proxy işlevselliği sağlar.

- Son HTML'yi okumak için sayfayı gerçek bir WebView'da (tarayıcıda) açmanıza olanak tanır.

- SmartThings Edge sürücüleri, yerel web sayfaları ve otomasyon komut dosyaları için aracı görevi görür.

2. Temel Bilgiler

- Varsayılan Port: 8088

- Varsayılan Adres Biçimi: http://cihazIP:8088

Örnek:

- http://192.168.219.137:8088

3. Ekran Düzeni

3.1 Sunucu Sekmesi

Sunucu Sekmesinde, köprü sunucusunun durumunu ve temel API'lerin nasıl kullanılacağını kontrol edebilirsiniz.

Görüntülenen içerik örnekleri:

- Köprü sunucu adresi

- /api/forward kullanım biçimi

- /api/web kullanım biçimi

- SmartThings kimlik doğrulama durumu kontrol API'si

- Arka plan WebView yürütme API'si

3.2 Ayarlar Sekmesi

Ayarlar sekmesinde, uygulamayı kullanmak için gerekli ortam ayarlarını ve durumunu kontrol edebilirsiniz.

Örnekler:

- Pil optimizasyonu istisna durumu

- Bildirim izni durumu

- Günlükleri görüntüle/kopyala

- Uygulama sürüm bilgisi

4. Temel API'ler

4.1 POST /api/ping

Açıklama: Köprü sunucu durumunu ve SmartThings kimlik doğrulama durumunu kısaca kontrol eder.

Yöntem:

- Yalnızca POST

Örnek:

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

Örnek yanıt:

{

"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

Açıklama:

Basit bir biçimde SmartThings cihazlarının listesini döndürür.

Yöntem:

- Yalnızca GET isteği

Örnek:

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

Örnek yanıt:

{

"items": [

{

"deviceId": "...",

"label": "Google Home Mini Library",

"name": "Google Home"

}

]

}

Kullanım Alanları:

- Cihaz adına göre deviceId'yi bulurken

- Hoparlör adlarını ararken

- Etiketlere göre cihaz seçerken

4.3 GET /api/forward?url=origin_address

Açıklama:

Standart bir HTTP proxy'si.

Yöntem:

- Yalnızca GET

Örnek:

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

Kullanım Alanları:

- JSON API çağrıları

- Statik HTML sayfalarının okunması

- SmartThings REST API çağrıları

Özellikler:

- Çoğu istek başlığını iletir

- SmartThings API'lerini çağırırken Yetkilendirme başlığı eksikse otomatik olarak kimlik bilgilerini kullanır

- JavaScript çalıştırmaz

- Cloudflare/tarayıcı doğrulama sayfalarına karşı zayıf olabilir

Dikkat:

- JavaScript çalıştırma gerektiren siteler için uygun değildir

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

Açıklama: Sayfayı gerçek bir WebView'da açar ve son HTML'yi döndürür.

Yöntem:

- GET veya POST

Kullanım:

- JavaScript yürütülmesini gerektiren siteler

- Cloudflare doğrulama sayfaları

- /api/forward üzerinden yüklenmeyen siteler

Örnek:

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

Veya:

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

Content-Type: application/json

{

"url": "https://",

"timeoutMs": 20000

}

Yanıt:

- Başarılı olursa son HTML gövdesi (text/html)

- Başarısız olursa hata dizesi

Özellikler:

- Sayfayı gerçek bir tarayıcı gibi açar

- JavaScript yürütülmesi mümkün

- Yavaş ama sağlam

Zaman Aşımı Parametreleri:

- timeout: saniye

- timeoutSeconds: saniye

- timeoutMs: milisaniye

Örnek:

- ?timeout=20

- ?timeoutSeconds=20

- ?timeoutMs=20000

Not:

- Yanıt, JSON değil, HTML gövdesinin kendisidir.

- Arayan, gerekli değerleri elde etmek için HTML'yi ayrıştırmalıdır.

4.5 GET veya POST /api/webview/run

Açıklama:

Belirli bir süre boyunca bir sayfayı arka planda WebView'da çalıştırır.

Yöntem:

- GET veya POST

Kullanım Alanları:

- Belirli bir sayfayı belirli bir süre boyunca arka planda çalışır durumda tutmak.

- JS işlemlerini/sayfa yürütmesini çalışır durumda tutmak.

Örnek:

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

Özellikler:

- Aynı anda 5 sayfaya kadar çalıştırır.

- Fazla istekler bir kuyrukta saklanır.

4.6 GET /api/webview/stop

Açıklama:

Arka planda çalışan bir WebView'ın yürütülmesini durdurur.

Yöntem:

- Şu anda GET olarak kullanılıyor

5. /api/forward ve /api/web arasındaki fark

/api/forward

- Standart HTTP proxy

- Hızlı

- JSON/API çağrıları için uygundur

- JavaScript çalıştırmaz

- Statik sayfalar/genel API'ler için uygundur

/api/web

- WebView tabanlı tarayıcı okuma

- Yavaş ama sağlam

- JavaScript çalıştırılabilir

- Cloudflare/tarayıcı doğrulama sayfalarını destekler

- Tarayıcı gerektiren sayfalar için uygundur

Önerilen Kriterler:

- Genel API'ler/Statik sayfalar: /api/forward

- Tarayıcıda açılması gereken sayfalar: /api/web

6. İzin Verilen Yöntemlerin Özeti

Sadece POST

- /api/ping

- /api/smartthings/token

- /api/smartthings/access-token

Sadece GET

- /api/smartthings/devices

- /api/forward

GET veya POST

- /api/web

- /api/webview/run

Durdurmak için

- /api/webview/stop

7. bridgeDevice Değerinin Açıklaması

/api/ping için bridgeDevice aşağıdakilerden biridir:

- tv

- pad

- phone

Belirleme Kriterleri:

- tv: Android TV / Leanback cihazları

- pad: smallestScreenWidthDp >= 600

- phone: Diğerleri

8. Kullanım Örnekleri

8.1 Sunucu Durumunu Kontrol Etme

POST /api/ping

8.2 Cihaz Listesini Kontrol Etme

GET /api/smartthings/devices

8.3 Genel API Proxy'si

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

8.4 Siteleri Okuma Tarayıcı Gerektirir

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

9. Özet

SmartWeb, Android cihazlarda çalışan yerel bir köprü sunucusudur.

Önemli Noktalar:

- SmartThings kimlik doğrulama durumunu kontrol etme

- Basit cihaz listesi API'si

- Standart HTTP proxy'si (/api/forward)

- WebView tabanlı tarayıcı okuma (/api/web)

- WebView'ı arka planda çalıştırma (/api/webview/run)

Özellikle, /api/web fonksiyonu, standart HTTP istekleriyle okunması zor olan sayfaları gerçek bir tarayıcı yöntemi kullanarak okumanıza olanak tanır.