Ikhtisar Otorisasi

Nest API menyediakan informasi yang dapat Anda gunakan untuk membuat pengalaman rumah. Informasi tersebut pada akhirnya dimiliki oleh pengguna, dan pengguna dapat secara eksplisit memilih untuk membagikan informasi ini dengan produk Works with Nest.

Tujuan otorisasi ini adalah untuk memberi pelanggan Anda sarana yang aman untuk memberikan akses ke data perangkat Nest mereka.

Alurnya terlihat seperti ini:

Ringkasan otorisasi

Situs atau aplikasi produk sebelum otorisasi

Di situs atau aplikasi produk, Anda dapat memberikan cara bagi pelanggan untuk memberikan produk Anda akses ke data perangkat Nest mereka. Untuk melakukannya, buat tombol atau elemen UI lainnya untuk memulai alur OAuth.

Saat membuat otorisasi pengguna ke dalam aplikasi, Anda dapat:

  • menggunakan browser eksternal untuk memberi otorisasi aplikasi
  • menggunakan halaman baru untuk mengautentikasi webapp

Untuk panduan desain selengkapnya, lihat Kebijakan desain Nest.

iFrame

iFrame menyajikan informasi, baik disematkan ke dalam halaman web atau sebagai webview dalam aplikasi asli. Alur OAuth tidak mendukung penyematan di iFrame.

Login Nest

Jika pengguna belum login, kita akan diminta untuk login.

Notifikasi koneksi (khusus pemilik)

Jika pengguna adalah anggota akun keluarga, dan tidak memiliki semua struktur di akun, notifikasi koneksi akan muncul setelah login. Notifikasi ini mencantumkan struktur yang dapat diberi otorisasi oleh pengguna untuk produk Works with Nest Anda.

Jika pengguna adalah pemilik akun, notifikasi koneksi tidak akan muncul, dan halaman izin akan langsung ditampilkan setelah login.

Untuk mengetahui informasi selengkapnya, lihat Akun Keluarga.

Otorisasi pengguna

Izin Nest

Kami akan meminta pengguna untuk memberikan akses ke produk Anda. Halaman ini menampilkan izin dan deskripsi yang Anda masukkan saat membuat klien.

Untuk informasi selengkapnya, lihat Ringkasan Izin.

Otorisasi pengguna

Situs atau aplikasi produk setelah otorisasi

Setelah pelanggan mengizinkan produk Works with Nest Anda, kami akan mengirimkan kode otorisasi yang dapat ditukarkan dengan token akses oleh produk Anda. Produk Works with Nest Anda kemudian dapat mengirim token akses dengan panggilan API untuk mengakses data Nest.

Pelanggan dapat mencabut akses kapan saja, sehingga produk Works with Nest Anda tidak membuat permintaan lebih lanjut untuk data perangkat pelanggan.

Untuk mempelajari cara menyiapkan alur otorisasi bagi pengguna dan mendapatkan token akses, lihat Autentikasi dan Otorisasi dengan OAuth 2.0.