Termostat API'sı

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

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

Aşağıdaki değerlerin tümü JSON belgesindeki her devices/thermostats/ device_id altında bulunur.

aygıt_no

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

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

yerel ayar

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

structure_id

Benzersiz tanımlayıcı yapı.

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ı. Sunduğumuz listeden 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

NAME_LONG

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

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 hizmeti ile ISO 8601 biçimindeki son başarılı etkileşimin zaman damgası.

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: true, false
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: true, false
Giriş	Sadece oku
Uygun	Termostat okuma / v1-v6 Termostat okuma / yazma / v1-v6

can_heat

Sistemin ısınma yeteneği.

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

is_using_emergency_heat

Acil Durum Soğutma için ısı pompaları bulunan sistemlerde ısı durumu.

Acil Durum Isı açıkken:

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

Acil Isı Nedir? Nest Thermostat'ın Acil Durum Isısı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: true, false
Giriş	Sadece oku
Uygun	Termostat okuma / v1-v6 Termostat okuma / yazma / v1-v6

has_fan

Sistemin fanı ısıtma veya soğutma işleminden bağımsız olarak kontrol edebilmesi.

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

fan_timer_active

Fan zamanlayıcısının takılı olup olmadığını gösterir; (kullanıcı tarafından belirtilen) önceden ayarlanmış bir süre boyunca fanı açmak için fan_timer_duration ile kullanılır.

Müşterilerin fan süresini nasıl ayarladıkları hakkında daha fazla bilgi için Gelişmiş Fan Kontrolü konusuna bakın.

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

fan_timer_timeout

Fan zamanlayıcısı ISO 8601 formatında 0'a (durma zamanı) ulaştığında gösterilen zaman damgası.

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 tasarrufu sıcaklığına ayarlandığında görüntülenir.

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

temperature_scale

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	oku: Termostat okuma / v1-v6 Termostat okuma / yazma / v1-v6 Yazmak: Termostat okuma / yazma / v5-v6

target_temperature_f

İstenen sıcaklık, tam Fahrenhayt derece (1 ° F). hvac_mode = heat veya cool olduğunda kullanılır.

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). hvac_mode = heat veya cool olduğunda kullanılır.

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

Fahrenhayt derece (1 ° F) cinsinden gösterilen maksimum hedef sıcaklık. hvac_mode = heat-cool (Isı • Soğutma modu) olduğunda kullanılır.

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

Maksimum hedef sıcaklık, yarım santigrat derece (0,5 ° C) olarak gösterilir. hvac_mode = heat-cool (Isı • Soğutma modu) olduğunda kullanılır.

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

Fahrenhayt derece (1 ° F) cinsinden görüntülenen minimum hedef sıcaklık. hvac_mode = heat-cool (Isı • Soğutma modu) olduğunda kullanılır.

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. hvac_mode = heat-cool (Isı • Soğutma modu) olduğunda kullanılır.

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

Maksimum Eko Sıcaklık, tam Fahrenheit (1 ° F) derece olarak gösterilir. hvac_mode = eco olduğunda kullanılır.

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 derece Santigrat (0,5 ° C) olarak gösterilir. hvac_mode = eco olduğunda kullanılır.

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 Fahrenheit (1 ° F) derece olarak gösterilir. hvac_mode = eco olduğunda kullanılır.

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, 0,5 ° C yarım santigrat olarak gösterilir. hvac_mode = eco olduğunda kullanılır.

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

away_temperature_high_f (DEPRECATED)

Fahrenhayt (1 ° F) derece cinsinden gösterilen maksimum uzak sıcaklık.

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

away_temperature_high_c (DEPRECATED)

Maksimum dış 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_high_c
İadeler	number Örnek: 24,5
Giriş	Sadece oku
Uygun	Termostat okuma / v1-v6 Termostat okuma / yazma / v1-v6

away_temperature_low_f (DEPRECATED)

Fahrenhayt (1 ° F) derece cinsinden görüntülenen minimum dış ortam 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

away_temperature_low_c (DEPRECATED)

En düşük dış ortam sıcaklığı, 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 kapasitesine sahip sistemler için Isı • Soğutma veya enerji tasarrufu için Eko Sıcaklıklar gibi HVAC sistemi ısıtma / soğutma modlarını gösterir.

• Termostat kilitliyse hvac_mode değiştirilebilir
• 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

ambient_temperature_f

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

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

ambient_temperature_c

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

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 hvac_state 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

where_id

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

Nest Thermostatts , Nest Protects ve Nest Cams için adların nerede olduğu hakkında daha fazla bilgi edinin.

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. locked_temp_min_f doğruysa, Termostat Kilidi özelliği etkinleştirilir ve sıcaklık aralığını şu min / maks değerleriyle sınırlar: 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: true, false
Giriş	Sadece oku
Uygun	Termostat okuma / v5-v6 Termostat okuma / yazma / v5-v6

locked_temp_min_f

Minimum Termostat Kilidi sıcaklığı, tam Fahrenheit (1 ° F) derece olarak gösterilir. is_locked true olduğunda kullanılır.

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

locked_temp_max_f

Maksimum Termostat Kilidi sıcaklığı, tam Fahrenheit (1 ° F) derece olarak gösterilir. is_locked true olduğunda kullanılır.

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

locked_temp_min_c

Minimum Termostat Kilidi sıcaklığı, yarım santigrat derece (0,5 ° C) olarak görüntülenir. is_locked true olduğunda kullanılır.

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

locked_temp_max_c

Maksimum Termostat Kilidi sıcaklığı, 0,5 santigrat derece (0 ° C) olarak gösterilir. is_locked true olduğunda kullanılır.

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 etiketi . 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 katta", "Misafir odası", "Oyun odası"
Giriş	okuma yazma
Uygun	oku: Termostat okuma / v6 Termostat okuma / yazma / v6 Yazmak: Termostat okuma / yazma / v5-v6

sunlight_correction_enabled

Güneş kremi etkin durumu. 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: true, false
Giriş	Sadece oku
Uygun	Termostat okuma / v6 Termostat okuma / yazma / v6

sunlight_correction_active

Güneş kremi etkin durumu. sunlight_correction_enabled . true olduğunda, Termostatın doğrudan güneş ışığı altında olduğ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: true, false
Giriş	Sadece oku
Uygun	Termostat okuma / v6 Termostat okuma / yazma / v6

where_name

Cihazın görünen adı. Termostat ile where_id . Sunduğumuz listeden herhangi bir oda adı veya özel bir ad olabilir. Nest Thermostatts , Nest Protects ve Nest Cams için adların nerede olduğu hakkında daha fazla bilgi edinin.

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 ayarlanacağı süreyi (dakika olarak) belirtir.

fan_timer_active ayarı fanı fan_timer_active . fan_timer_timeout değeri fan_timer_duration şekilde ayarlandığında zaman damgasını gösterir.

Müşterilerin fan zamanlayıcısını nasıl ayarladığını öğ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	oku: 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 dakika cinsinden süre.

Daha fazla bilgi için Sıcaklık Zamanı'na bakınız.

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

Egzersiz modundayken Nest Thermostat HVAC sistemini öğrenir ve hedef sıcaklığa ulaşmak için ne kadar zaman gerektiğini bulur. Termostat hedef sıcaklığa ulaşma süresini makul bir şekilde tahmin etmek için yeterli bilgiye sahip olduğunda, bu değer training ready .

Daha fazla bilgi için Sıcaklık Zamanı'na bakınız.

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

previous_hvac_mode

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

Eko ve Eko olmayan modlar arasında geçiş yapma hakkında daha fazla bilgi 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