Nest API dostarcza informacji, których możesz użyć do tworzenia domowych doświadczeń. Informacje są ostatecznie własnością użytkowników, a użytkownicy mogą jawnie zdecydować o udostępnieniu tych informacji produktom Works with Nest.
Celem autoryzacji jest zapewnienie Twoim klientom bezpiecznego sposobu udzielania dostępu do danych ich urządzeń Nest.
Przepływ wygląda następująco:
Witryna produktu lub aplikacja przed autoryzacją
W swojej witrynie lub aplikacji możesz udostępnić klientom sposób, w jaki mogą uzyskać dostęp do danych ich urządzeń Nest. Aby to zrobić, utwórz przycisk lub inny element interfejsu użytkownika, aby zainicjować przepływ OAuth.
Kiedy tworzysz autoryzację użytkownika w swojej aplikacji, możesz:
- użyj zewnętrznej przeglądarki do autoryzacji aplikacji
- użyj nowej strony do autoryzacji aplikacji internetowej
Więcej wskazówek dotyczących projektowania można znaleźć w zasadach projektowania Nest .
iFrames
Ramki iFrames przedstawiają informacje osadzone na stronie internetowej lub jako widok sieciowy w aplikacji natywnej. Przepływ OAuth nie obsługuje osadzania w elementach iFrame .
Logowanie do Nest
Jeśli użytkownik nie jest jeszcze zalogowany, monitujemy go o zalogowanie.
Powiadomienie o połączeniu (tylko nie-właściciel)
Jeśli użytkownik jest członkiem konta rodzinnego i nie posiada wszystkich struktur na koncie, po zalogowaniu pojawia się powiadomienie o połączeniu. To powiadomienie zawiera listę struktur, do których użytkownik może autoryzować Twój produkt Works with Nest.
Jeśli użytkownik jest właścicielem konta, powiadomienie o połączeniu nie jest wyświetlane, a strona uprawnień jest wyświetlana natychmiast po zalogowaniu.
Aby uzyskać więcej informacji, zobacz Konta rodzinne .
Uprawnienia Nest
Poprosimy użytkownika o przyznanie dostępu do Twojego produktu. Ta strona wyświetla uprawnienia i opisy wprowadzone podczas tworzenia klienta.
Aby uzyskać więcej informacji, zobacz Omówienie uprawnień .
Witryna produktu lub aplikacja po autoryzacji
Gdy klient autoryzuje Twój produkt Works with Nest, wyślemy kod autoryzacyjny, który Twój produkt może wymienić na token dostępu. Twój produkt Works with Nest może następnie wysłać token dostępu z wywołaniami API w celu uzyskania dostępu do danych Nest.
Twoi klienci mogą cofnąć dostęp w dowolnym momencie, co uniemożliwi Twojemu produktowi Works with Nest wysyłanie dalszych żądań dotyczących danych urządzenia klienta.
Aby dowiedzieć się, jak skonfigurować przepływ autoryzacji dla użytkownika i uzyskać token dostępu, zobacz Uwierzytelnianie i autoryzacja za pomocą OAuth 2.0 .