Termostat API'si

Nest API, AB'deki Isı Bağlantılı Termostat E hariç tüm Nest Learning Thermostat™ modelleriyle çalışır.

Kullanıcılar için birden Nest termostatlar ekleyebilir devices/thermostats için, grubun yukarı yapının başına maksimum . Bu veri konumuna çağrı yaptığınızda Nest Thermostat verilerine (yapıdaki cihazlar için veri değerleri) erişebilirsiniz.

Değerlerin altında tüm her birinin altında bulunan devices/thermostats/ device_id JSON belgede.

device_id

Nest Thermostat benzersiz tanımlayıcısı.

Ayrıntılar
https://developer-api.nest.com/devices/thermostats/ device_id /device_id
İadeler	string Örnek: "peyiJNo0IldT2YliIVtYaGQ"
Giriş	Sadece oku
Uygun	Termostat okuma / v1-v6 Termostat okuma/yazma / v1-v6

yerel

Dil ve bölge (veya ülke) tercihini belirtir.

Ayrıntılar
https://developer-api.nest.com/devices/thermostats/ device_id /locale
İadeler	string Örnekler: "en-GB", "en-US", "es-US", "fr-CA", "fr-CA", "nl-NL"
Giriş	Sadece oku
Uygun	Termostat okuma / v1-v6 Termostat okuma/yazma / v1-v6

yazılım versiyonu

Yazılım versiyonu.

Ayrıntılar
https://developer-api.nest.com/devices/thermostats/ device_id /software_version
İadeler	string Örnek: "4.0"
Giriş	Sadece oku
Uygun	Termostat okuma / v1-v6 Termostat okuma/yazma / v1-v6

yapı_kimliği

Yapı benzersiz tanımlayıcısı.

Ayrıntılar
https://developer-api.nest.com/devices/thermostats/ device_id /structure_id
İadeler	string Örnek: "VqFabWH21nw..."
Giriş	Sadece oku
Uygun	Termostat okuma / v1-v6 Termostat okuma/yazma / v1-v6

isim

Cihazın görünen adı. Sağladığımız bir listedeki herhangi bir oda adı veya özel bir ad olabilir.

Ayrıntılar
https://developer-api.nest.com/devices/thermostats/ device_id /name
İadeler	string Örnek: "Koridor"
Giriş	Sadece oku
Uygun	Termostat okuma / v1-v6 Termostat okuma/yazma / v1-v6

isim_uzun

Cihazın uzun görünen adı. Kullanıcı tarafından oluşturulan özel (etiket), içerir veya üzeri wheres .

Ayrıntılar
https://developer-api.nest.com/devices/thermostats/ device_id /name_long
İadeler	string Örnek: "Koridor Termostatı (üst katta)"
Giriş	Sadece oku
Uygun	Termostat okuma / v1-v6 Termostat okuma/yazma / v1-v6

last_connection

Nest hizmetiyle son başarılı etkileşim, zaman damgası ISO 8601 formatında.

Ayrıntılar
https://developer-api.nest.com/devices/thermostats/ device_id /last_connection
İadeler	string Örnek: "2016-12-31T23:59:59.000Z"
Giriş	Sadece oku
Uygun	Termostat okuma / v1-v6 Termostat okuma/yazma / v1-v6

is_online

Nest hizmetiyle cihaz bağlantı durumu.

Ayrıntılar
https://developer-api.nest.com/devices/thermostats/ device_id /is_online
İadeler	boolean Değerler: doğru, yanlış
Giriş	Sadece oku
Uygun	Termostat okuma / v1-v6 Termostat okuma/yazma / v1-v6

can_cool

Sistem soğutma yeteneği (AC'ye sahiptir).

Ayrıntılar
https://developer-api.nest.com/devices/thermostats/ device_id /can_cool
İadeler	boolean Değerler: doğru, yanlış
Giriş	Sadece oku
Uygun	Termostat okuma / v1-v6 Termostat okuma/yazma / v1-v6

can_heat

Sistem ısıtma yeteneği.

Ayrıntılar
https://developer-api.nest.com/devices/thermostats/ device_id /can_heat
İadeler	boolean Değerler: doğru, yanlış
Giriş	Sadece oku
Uygun	Termostat okuma / v1-v6 Termostat okuma/yazma / v1-v6

is_using_emergency_heat

Soğutma için ısı pompalı sistemlerde Acil Isı durumu.

Acil Isıtma açıkken:

• Kullanıcı cihaz üzerinde hedef sıcaklığı ayarlayabilir ancak Acil Isıtma kapatılana kadar modu değiştiremez.
• hvac_mode hala API üzerinden değiştirilebilir

Bkz Ne Var Acil Heat? Nest Thermostat'ın Acil Durum Isıtmasını nasıl desteklediği hakkında daha fazla bilgi için.

Ayrıntılar
https://developer-api.nest.com/devices/thermostats/ device_id /is_using_emergency_heat
İadeler	boolean Değerler: doğru, yanlış
Giriş	Sadece oku
Uygun	Termostat okuma / v1-v6 Termostat okuma/yazma / v1-v6

has_fan

Fanı ısıtma veya soğutmadan bağımsız olarak kontrol eden sistem yeteneği.

Ayrıntılar
https://developer-api.nest.com/devices/thermostats/ device_id /has_fan
İadeler	boolean Değerler: doğru, yanlış
Giriş	Sadece oku
Uygun	Termostat okuma / v1-v6 Termostat okuma/yazma / v1-v6

fan_timer_active

Fan zamanlayıcısının devreye girip girmediğini gösterir; ile birlikte kullanılabilir fan_timer_duration bir (kullanıcı tarafından belirlenen) önceden belirlenmiş bir süre için fanın açın.

Bkz Gelişmiş Fan Kontrolü müşterileri Fan süresini ayarlamak konusunda daha fazla bilgi için.

Ayrıntılar
https://developer-api.nest.com/devices/thermostats/ device_id /fan_timer_active
İadeler	boolean Değerler: doğru, yanlış
Giriş	okuma yazma
Uygun	Termostat okuma / v1-v6 Termostat okuma/yazma / v1-v6

fan_timer_timeout

Fan zamanlayıcısı 0 (durma süresi) ulaştığında Damgası içinde gösteren ISO 8601 formatında.

Ayrıntılar
https://developer-api.nest.com/devices/thermostats/ device_id /fan_timer_timeout
İadeler	string Örnek: "2016-12-31T23:59:59.000Z"
Giriş	Sadece oku
Uygun	Termostat okuma / v1-v6 Termostat okuma/yazma / v1-v6

has_leaf

Termostat enerji tasarruflu bir sıcaklığa ayarlandığında görüntülenir.

Ayrıntılar
https://developer-api.nest.com/devices/thermostats/ device_id /has_leaf
İadeler	boolean Değerler: doğru, yanlış
Giriş	Sadece oku
Uygun	Termostat okuma / v1-v6 Termostat okuma/yazma / v1-v6

sıcaklık_ölçeği

Fahrenhayt veya Santigrat; sıcaklık göstergesi ile kullanılır.

Ayrıntılar
https://developer-api.nest.com/devices/thermostats/ device_id /temperature_scale
İadeler	string enum Değerler: "F", "C"
Giriş	okuma yazma
Uygun	Okuyun: Termostat okuma / v1-v6 Termostat okuma/yazma / v1-v6 Yazmak: Termostat okuma/yazma / v5-v6

target_temperature_f

İstenen sıcaklık, tam derece Fahrenheit (1°F). Kullanılır hvac_mode = heat veya cool .

Ayrıntılar
https://developer-api.nest.com/devices/thermostats/ device_id /target_temperature_f
İadeler	number Örnek: 72
Aralık	50-90
Giriş	okuma yazma
Uygun	Termostat okuma / v1-v6 Termostat okuma/yazma / v1-v6

target_temperature_c

İstenen sıcaklık, yarım santigrat derece (0,5°C). Kullanılır hvac_mode = heat veya cool .

Ayrıntılar
https://developer-api.nest.com/devices/thermostats/ device_id /target_temperature_c
İadeler	number Örnek: 21.5
Aralık	9-32
Giriş	okuma yazma
Uygun	Termostat okuma / v1-v6 Termostat okuma/yazma / v1-v6

target_temperature_high_f

Tam Fahrenheit (1°F) olarak gösterilen maksimum hedef sıcaklık. Kullanılan zaman hvac_mode = heat-cool (Heat • Soğuk modu).

Ayrıntılar
https://developer-api.nest.com/devices/thermostats/ device_id /target_temperature_high_f
İadeler	number Örnek: 80
Giriş	okuma yazma
Uygun	Termostat okuma / v1-v6 Termostat okuma/yazma / v1-v6

target_temperature_high_c

Yarım santigrat derece (0,5°C) olarak gösterilen maksimum hedef sıcaklık. Kullanılan zaman hvac_mode = heat-cool (Heat • Soğuk modu).

Ayrıntılar
https://developer-api.nest.com/devices/thermostats/ device_id /target_temperature_high_c
İadeler	number Örnek: 24.5
Giriş	okuma yazma
Uygun	Termostat okuma / v1-v6 Termostat okuma/yazma / v1-v6

target_temperature_low_f

Minimum hedef sıcaklık, tam derece Fahrenheit (1°F) olarak gösterilir. Kullanılan zaman hvac_mode = heat-cool (Heat • Soğuk modu).

Ayrıntılar
https://developer-api.nest.com/devices/thermostats/ device_id /target_temperature_low_f
İadeler	number Örnek: 65
Giriş	okuma yazma
Uygun	Termostat okuma / v1-v6 Termostat okuma/yazma / v1-v6

target_temperature_low_c

Minimum hedef sıcaklık, yarım santigrat derece (0,5°C) olarak gösterilir. Kullanılan zaman hvac_mode = heat-cool (Heat • Soğuk modu).

Ayrıntılar
https://developer-api.nest.com/devices/thermostats/ device_id /target_temperature_low_c
İadeler	number Örnek: 19.5
Giriş	okuma yazma
Uygun	Termostat okuma / v1-v6 Termostat okuma/yazma / v1-v6

eco_temperature_high_f

Tam Fahrenheit (1°F) olarak gösterilen Maksimum Eko Sıcaklık. Kullanılır hvac_mode = eco .

Ayrıntılar
https://developer-api.nest.com/devices/thermostats/ device_id /eco_temperature_high_f
İadeler	number Örnek: 80
Giriş	Sadece oku
Uygun	Termostat okuma / v6 Termostat okuma/yazma / v6

eco_temperature_high_c

Maksimum Eko Sıcaklık, yarım santigrat derece (0,5°C) olarak gösterilir. Kullanılır hvac_mode = eco .

Ayrıntılar
https://developer-api.nest.com/devices/thermostats/ device_id /eco_temperature_high_c
İadeler	number Örnek: 24.5
Giriş	Sadece oku
Uygun	Termostat okuma / v6 Termostat okuma/yazma / v6

eco_temperature_low_f

Minimum Eko Sıcaklık, tam derece Fahrenheit (1°F) olarak gösterilir. Kullanılır hvac_mode = eco .

Ayrıntılar
https://developer-api.nest.com/devices/thermostats/ device_id /eco_temperature_low_f
İadeler	number Örnek: 65
Giriş	Sadece oku
Uygun	Termostat okuma / v6 Termostat okuma/yazma / v6

eco_temperature_low_c

Minimum Eko Sıcaklık, yarım santigrat derece (0,5°C) olarak gösterilir. Kullanılır hvac_mode = eco .

Ayrıntılar
https://developer-api.nest.com/devices/thermostats/ device_id /eco_temperature_low_c
İadeler	number Örnek: 19.5
Giriş	Sadece oku
Uygun	Termostat okuma / v6 Termostat okuma/yazma / v6

uzakta_temperature_high_f (KALDIRILDI)

Tam Fahrenheit (1°F) cinsinden gösterilen maksimum uzaklık sıcaklığı.

Ayrıntılar
https://developer-api.nest.com/devices/thermostats/ device_id /away_temperature_high_f
İadeler	number Örnek: 80
Giriş	Sadece oku
Uygun	Termostat okuma / v1-v6 Termostat okuma/yazma / v1-v6

uzakta_temperature_high_c (KALDIRILDI)

Yarım santigrat derece (0,5°C) olarak gösterilen maksimum dış ortam sıcaklığı.

Ayrıntılar
https://developer-api.nest.com/devices/thermostats/ device_id /away_temperature_high_c
İadeler	number Örnek: 24.5
Giriş	Sadece oku
Uygun	Termostat okuma / v1-v6 Termostat okuma/yazma / v1-v6

uzakta_temperature_low_f (KALDIRILDI)

Tam Fahrenheit (1°F) olarak gösterilen minimum uzaklık sıcaklığı.

Ayrıntılar
https://developer-api.nest.com/devices/thermostats/ device_id /away_temperature_low_f
İadeler	number Örnek: 65
Giriş	Sadece oku
Uygun	Termostat okuma / v1-v6 Termostat okuma/yazma / v1-v6

uzakta_temperature_low_c (KALDIRILDI)

Minimum uzak sıcaklık, yarım santigrat derece (0,5°C) olarak gösterilir.

Ayrıntılar
https://developer-api.nest.com/devices/thermostats/ device_id /away_temperature_low_c
İadeler	number Örnek: 19.5
Giriş	Sadece oku
Uygun	Termostat okuma / v1-v6 Termostat okuma/yazma / v1-v6

hvac_mode

Isıtma ve soğutma kapasiteli sistemler için Heat•Cool veya enerji tasarrufu için Eko Sıcaklıklar gibi HVAC sistemi ısıtma/soğutma modlarını gösterir.

• hvac_mode Termostat ise değiştirilebilir kilitli
• target_temperature_f ve target_temperature_c eğer değiştirilemez hvac_mode = off veya eco

Ayrıntılar
https://developer-api.nest.com/devices/thermostats/ device_id /hvac_mode
İadeler	string enum Değerler: "heat", "cool", "heat-cool", "eco", "off"
Giriş	okuma yazma
Uygun	Termostat okuma / v1-v6 Termostat okuma/yazma / v1-v6

ortam_sıcaklığı_f

Cihazda ölçülen sıcaklık, tam derece Fahrenheit (1°F).

Ayrıntılar
https://developer-api.nest.com/devices/thermostats/ device_id /ambient_temperature_f
İadeler	number Örnek: 72
Giriş	Sadece oku
Uygun	Termostat okuma / v1-v6 Termostat okuma/yazma / v1-v6

ortam_sıcaklığı_c

Cihazda ölçülen sıcaklık, yarım santigrat derece (0,5°C).

Ayrıntılar
https://developer-api.nest.com/devices/thermostats/ device_id /ambient_temperature_c
İadeler	number Örnek: 21.5
Giriş	Sadece oku
Uygun	Termostat okuma / v1-v6 Termostat okuma/yazma / v1-v6

nem

Cihazda ölçülen, yüzde (%) formatında nem, en yakın %5'e yuvarlanır.

Ayrıntılar
https://developer-api.nest.com/devices/thermostats/ device_id /humidity
İadeler	number Örnek: 35
Aralık	0-100
Giriş	Sadece oku
Uygun	Termostat okuma / v2-v6 Termostat okuma/yazma / v2-v6

hvac_state

HVAC sisteminin aktif olarak ısıtma, soğutma veya kapalı olduğunu gösterir. HVAC aktivite durumunu belirtmek için bu değeri kullanın.

Zaman off , HVAC sistemi aktif ısıtma ya da soğutma değildir. hvac_state Fan çalışması bağımsızdır.

Ayrıntılar
https://developer-api.nest.com/devices/thermostats/ device_id /hvac_state
İadeler	string enum Değerler: "ısıtma", "soğutma", "kapalı"
Giriş	Sadece oku
Uygun	Termostat okuma / v3-v6 Termostat okuma/yazma / v3-v6

nerede_kimlik

Temsil eden bir tek, Yuva oluşturulan tanımlayıcı name cihazın görüntü adı.

Daha fazla bilgi için isimleri nerede öğrenin Nest Termostatlar ,Nest korur ve Yuvası Kameralar .

Ayrıntılar
https://developer-api.nest.com/devices/thermostats/ device_id /where_id
İadeler	string Örnek: "d6reb_OZTM..."
Giriş	Sadece oku
Uygun	Termostat okuma / v4-v6 Termostat okuma/yazma / v4-v6

kilitli

Termostat Kilidi durumu. Ne zaman gerçek, Termostat Kilidi özelliği etkin ve bu min / max değerleri, sıcaklık aralığını kısıtlar: locked_temp_min_f , locked_temp_max_f , locked_temp_min_c ve locked_temp_max_c .

Ayrıntılar
https://developer-api.nest.com/devices/thermostats/ device_id /is_locked
İadeler	boolean Değerler: doğru, yanlış
Giriş	Sadece oku
Uygun	Termostat okuma / v5-v6 Termostat okuma/yazma / v5-v6

kilitli_temp_min_f

En az Termostat Kilit bütün derece Fahrenheit (1 ° C) 'de gösterilen sıcaklık. Kullanılır is_locked olduğu true .

Ayrıntılar
https://developer-api.nest.com/devices/thermostats/ device_id /locked_temp_min_f
İadeler	string Örnek: 65
Giriş	Sadece oku
Uygun	Termostat okuma / v5-v6 Termostat okuma/yazma / v5-v6

kilitli_temp_max_f

Maksimum Termostat Kilit bütün derece Fahrenheit (1 ° C) 'de gösterilen sıcaklık. Kullanılır is_locked olduğu true .

Ayrıntılar
https://developer-api.nest.com/devices/thermostats/ device_id /locked_temp_max_f
İadeler	string Örnek: 80
Giriş	Sadece oku
Uygun	Termostat okuma / v5-v6 Termostat okuma/yazma / v5-v6

kilitli_temp_min_c

En az Termostat Kilit sıcaklığı, yarım derecelik görüntülenen Celsius (0.5 ° C) olarak gösterilmektedir. Kullanılır is_locked olduğu true .

Ayrıntılar
https://developer-api.nest.com/devices/thermostats/ device_id /locked_temp_min_c
İadeler	string Örnek: 19.5
Giriş	Sadece oku
Uygun	Termostat okuma / v5-v6 Termostat okuma/yazma / v5-v6

kilitli_temp_max_c

Maksimum Termostat Kilit sıcaklığı, yarım derecelik görüntülenen Celsius (0.5 ° C) olarak gösterilmektedir. Kullanılır is_locked olduğu true .

Ayrıntılar
https://developer-api.nest.com/devices/thermostats/ device_id /locked_temp_max_c
İadeler	string Örnek: 24.5
Giriş	Sadece oku
Uygun	Termostat okuma / v5-v6 Termostat okuma/yazma / v5-v6

etiket

Termostat özel etiket . Nerede adından sonra parantez içinde görünür.

Ayrıntılar
https://developer-api.nest.com/devices/thermostats/ device_id /label
İadeler	string Örnekler: "Üst kat", "Misafir odası", "Oyun odası"
Giriş	okuma yazma
Uygun	Okuyun: Termostat okuma / v6 Termostat okuma/yazma / v6 Yazmak: Termostat okuma/yazma / v5-v6

güneş ışığı_düzeltme_etkin

Güneş kremi etkin durumu. İle kullanılır sunlight_correction_active . Ne zaman true , Sunblock teknolojisi etkindir ve Termostat otomatik olarak doğrudan güneş ışığına ayarlayarak okuma ve doğru sıcaklığa ayarlıyor.

Daha fazla bilgi için, bkz Sunblock nedir?

Ayrıntılar
https://developer-api.nest.com/devices/thermostats/ device_id /sunlight_correction_enabled
İadeler	boolean Değerler: doğru, yanlış
Giriş	Sadece oku
Uygun	Termostat okuma / v6 Termostat okuma/yazma / v6

güneş ışığı_düzeltme_aktif

Güneş kremi aktif durumu. İle kullanılır sunlight_correction_enabled . Ne zaman true , Termostat doğrudan güneş ışığı bulunduğunu gösterir.

Daha fazla bilgi için, bkz Sunblock nedir?

Ayrıntılar
https://developer-api.nest.com/devices/thermostats/ device_id /sunlight_correction_active
İadeler	boolean Değerler: doğru, yanlış
Giriş	Sadece oku
Uygun	Termostat okuma / v6 Termostat okuma/yazma / v6

nerede_adı

Cihazın görünen adı. Termostat ile İlişkili where_id . Sağladığımız bir listedeki herhangi bir oda adı veya özel bir ad olabilir. Daha fazla bilgi için isimleri nerede öğrenin Nest Termostatlar ,Nest korur ve Yuvası Kameralar .

Ayrıntılar
https://developer-api.nest.com/devices/thermostats/ device_id /where_name
İadeler	string Örnek: "Koridor"
Giriş	Sadece oku
Uygun	Termostat okuma / v6 Termostat okuma/yazma / v6

fan_timer_duration

Fanın çalışmaya ayarlandığı süreyi (dakika olarak) belirtir.

fan_timer_active ayar fanı çalıştırır. fan_timer_timeout değeri zaman damgası gösterir fan_timer_duration ucuna ayarlanır.

Müşterilerin fan sayacı ayarlamak öğrenmek için, bkz Zamanlayıcı Süresi .

Ayrıntılar
https://developer-api.nest.com/devices/thermostats/ device_id /fan_timer_duration
İadeler	int Değerler: 15, 30, 45, 60, 120, 240, 480, 720
Giriş	okuma yazma
Uygun	Okuyun: Termostat okuma / v6 Termostat okuma/yazma / v6 Yazmak: Termostat okuma/yazma / v6

time_to_target

Yapının hedef sıcaklığa ulaşması için gereken süre (dakika).

Bkz Süresini Sıcaklığı Daha fazla bilgi için.

Ayrıntılar
https://developer-api.nest.com/devices/thermostats/ device_id /time_to_target
İadeler	string enum Değerler: "~0", "<5", "~15", "~90", "120"
Giriş	Sadece oku
Uygun	Termostat okuma / v6 Termostat okuma/yazma / v6

time_to_target_training

Nest Thermostat, eğitim modundayken HVAC sistemi hakkında bilgi edinir ve hedef sıcaklığa ulaşmanın ne kadar sürdüğünü keşfeder. Termostat hedef sıcaklığa ulaşmak için bir zaman makul bir tahmin yapmak için yeterli bilgiye sahip olduğunda, bu değer değişecektir training için ready .

Bkz Süresini Sıcaklığı Daha fazla bilgi için.

Ayrıntılar
https://developer-api.nest.com/devices/thermostats/ device_id /time_to_target_training
İadeler	string enum Değerler: "eğitim", "hazır"
Giriş	Sadece oku
Uygun	Termostat okuma / v6 Termostat okuma/yazma / v6

önceki_hvac_mode

Son seçilen görüntüler hvac_mode . Geçildiğinde kullanılır hvac_mode = eco eski firmware ile bir cihazda.

Eco and olmayan Eko modları betwen değiştirme hakkında daha fazla bilgi edinmek için bkz Termostat Kılavuzu .

Ayrıntılar
https://developer-api.nest.com/devices/thermostats/ device_id /previous_hvac_mode
İadeler	string Değerler: "heat", "cool", "heat-cool", "off", boş (değer yok)
Giriş	Sadece oku
Uygun	Termostat okuma / v6 Termostat okuma/yazma / v6