Dokumentacja Nest API

Interfejs Nest API modeluje dom i budynek jako strukturę z urządzeniami Nest Learning Thermostat, Nest Protect i Nest Cam jako urządzeniami w strukturze. Ta struktura zawiera też informacje o całym domu (np. Poza domem, szacowanym czasem dotarcia i godzinami największego zużycia).

Do każdego elementu danych w strukturze można dodać adres URL zasobu (nazywany „"datadata"”) w udostępnionym dokumencie JSON. Każda lokalizacja może przechowywać ciągi, liczby, wartości logiczne, obiekty nadrzędne/podrzędne lub tablice.

Zapoznaj się z modelem danych z tego interaktywnego pliku API.

Za pomocą interfejsu API możesz synchronizować dane z lokalizacji na wielu poziomach w modelu danych, na przykład:

  • całą strukturę, w tym wszystkie urządzenia
  • pojedyncze urządzenie w budynku
  • grupa wartości danych (bieżąca i temperatura otoczenia)
  • 1 wartość danych (stan baterii)

Produkty powinny odpowiadać na takie wydarzenia:

Pamiętaj jednak, że wszystkie obiekty oparte na urządzeniach działają zgodnie z rzeczywistymi ograniczeniami. Na przykład termostat nie powinien włączać klimatyzacji gdy ogrzewanie awaryjne jest włączone. Nasz interfejs API został opracowany tak, aby chronić zarówno nasze urządzenia, jak i dom użytkownika oraz uniemożliwiać wykonywanie określonych działań, jeśli mogą one być zaskakujące lub niebezpieczne.

Uprawnienia i udostępnione dane z urządzenia

Uprawnienia do odczytu i zapisu w lokalizacji danych określają uprawnienia. Grupy uprawnień zapewniają dostęp do wybranych wartości danych na urządzeniach i w strukturach z możliwością ich odczytu, zapisu i odczytu.

Więcej informacji znajdziesz w Przeglądzie uprawnień.

Dane i prywatność

Dane związane z produktami domowymi mogą być bardzo osobiste. Dane z czujników domu zawierają informacje o tym, jak ludzie żyją w przestrzeni osobistej. Bezpieczeństwo i obsługa tych danych jest bardzo ważne i stanowi podstawę Nest. Wyjaśniamy użytkownikom, jakie dane mamy, jak je wykorzystujemy oraz gdzie można je kontrolować.

Dowiedz się więcej o naszych poglądach na temat prywatności.

Metadane

Metadane to dodatkowe informacje, które są udostępniane przy wywoływaniu punktu końcowego poziomu głównego:

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

token_dostępu

Po autoryzacji użytkownika usługa używa tokena dostępu, aby wykonywać wywołania interfejsu API do usługi Nest. Jest on dowodem na to, że użytkownik upoważnił Twój produkt do wykonywania połączeń w jego imieniu.

Szczegóły
Zwrotystring
Przykład: "c.FmDPkzyzaQe..."

wersja_klienta

Wersja klienta to ostatnia autoryzowana wersja klienta i jest powiązana z access_token.

Gdy zaktualizujesz uprawnienia klienta, wersja klienta zostanie zwiększona, a użytkownik otrzyma powiadomienie o dostępnej aktualizacji. Użytkownicy muszą zaakceptować tę aktualizację klienta, aby mogli używać zaktualizowanej usługi.

Szczegóły
Zwrotynumber
Przykłady: 1, 17, 42

user_id

Identyfikator użytkownika pozwala identyfikować użytkowników w wywołaniach interfejsu API. Ten identyfikator różni się w zależności od usługi Works with Nest i użytkownika.

Jeśli np. użytkownik 1 autoryzował produkty Współpracujące z produktem Nest A i produktami Nest z produktu B, produkt A ma 1 wartość user_id dla użytkownika 1 i produkt B ma inną wartość user_id dla użytkownika 1.

Szczegóły
Zwrotystring
Przykład: z.1.1.7DHps...