Nest API Referansı

Nest API, yapı olarak cihaz olarak Nest Learning Thermostat, Nest Protect ve Nest Cam'in olduğu, fiziksel bir ev veya binayı yapı olarak modeller. Bu yapı, evle ilgili tüm bilgileri (ör. Dışarıda veya TVS durumu ya da etkin Yoğun Kullanım Saatleri) de içerir.

Yapıdaki her veri öğesi, paylaşılan bir JSON dokümanındaki bir kaynak URL'si ("veri konumları" olarak adlandırılır) tarafından ele alınabilir. Her veri konumu dize, sayı, boole, üst/alt nesne veya dizi depolayabilir.

Bu etkileşimli API Referansı ile veri modelini keşfedin.

API'den, veri modelinde konumlardaki birden fazla düzeydeki konumlardaki verileri senkronize edebilirsiniz. Örneğin:

  • Tüm cihazlar dahil tüm yapı
  • yapıda tek bir cihaz
  • bir veri değerleri grubu (geçerli ve ortam sıcaklığı)
  • tek bir veri değeri (pil sağlığı durumu)

Ürünleriniz, aşağıdaki gibi olaylara dikkat ederek yanıt vermelidir:

Ancak cihaz tabanlı nesnelerin her birinin gerçek dünyadaki kısıtlamaların altında çalıştığını unutmayın. Örneğin, acil durum ısısı etkinken termostatı çalıştırmamalıdır. API'miz hem cihazlarımızı hem de kullanıcıların evini koruyacak şekilde tasarlanmıştır. Ayrıca şaşırtıcı veya tehlikeli olabilecek belirli işlemleri engellerler.

İzinler ve paylaşılan cihaz verileri

Bir veri konumunu okuma veya yazma özelliği izinler tarafından kontrol edilir. İzin grupları, cihazlar ve yapılardaki seçili veri değerlerine okuma, yazma veya okuma/yazma erişimi sağlar.

Daha fazla bilgi için İzinlere Genel Bakış konusuna bakın.

Veriler ve gizlilik

Ev ürünleriyle ilgili veriler çok kişisel olabilir. Ev sensörü verileri insanların kişisel alanlarında hayatlarını nasıl yaşadıklarıyla ilgili bilgiler içerir. Bu verilerin güvenliği ve işlenmesi çok önemlidir. Bu nedenle Nest'te önemli bir odak noktası vardır. Ne tür verilere sahip olduğumuzu, bunları nasıl kullandığımızı ve verileri nereden kontrol edebildiğimizi kullanıcılara net bir şekilde açıklıyoruz.

Gizlilikle ilgili görünümlerimiz hakkında daha fazla bilgi edinin.

Meta veri

Meta veri, kök düzeyinde uç noktaya bir çağrı yaptığınızda sağladığınız ek bilgilerdir:

https://developer-api.nest.com/

erişim_jetonu

Kullanıcı yetkilendirmesinden sonra ürününüz Nest hizmetine API çağrıları yapmak için bir erişim jetonu kullanır. Bu erişim jetonu, kullanıcıların ürününüze kendi adlarına arama yapma yetkisi verdiğini kanıtlar.

Ayrıntılar
İadelerstring
Örnek: "c.FmDPkzyzaQe..."

istemci_sürümü

İstemci sürümü, istemcinin kullanıcı tarafından yetkilendirilen son sürümüdür ve bir access_token ile ilişkilendirilir.

Bir istemcinin izinlerini güncellediğinizde, istemci sürümü artar ve kullanıcıya güncelleme mevcut olduğu bildirilir. Güncellenen ürününüzü kullanabilmeleri için kullanıcılarınızın bu istemci güncellemesini kabul etmesi gerekir.

Ayrıntılar
İadelernumber
Örnekler: 1, 17, 42

user_id

User-ID, API çağrıları genelinde kullanıcıları tanımlamanızı sağlar. Bu tanımlayıcı, Nest ile çalışan her Ürün ve kullanıcı kombinasyonu için farklıdır.

Örneğin, 1. kullanıcı, Works with Nest ürünü A ve Works with Nest ürününü yetkilendirdiyse A ürününün 1. kullanıcı için bir user_id değeri ve B ürününün 1. kullanıcı için farklı bir user_id değeri vardır.

Ayrıntılar
İadelerstring
Örnek: z.1.1.7DHps...