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 | |
|---|---|
| Zwroty | stringPrzykł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 | |
|---|---|
| Zwroty | numberPrzykł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 | |
|---|---|
| Zwroty | stringPrzykład: z.1.1.7DHps... |