Tentang layanan Nest
Aplikasi Nest memungkinkan pengguna terhubung dengan rumah mereka dari mana pun mereka berada. Semua perangkat Nest (Thermostat, Protect, dan Camera) dan aplikasi (iOS, Android, dan aplikasi web) terhubung ke layanan Nest.
Layanan Nest menyediakan model data rumah. Perangkat dan aplikasi membaca dari model data ini untuk mengambil tindakan yang tepat. Model ini memperbarui model data untuk mencerminkan perubahan dalam sistem.
Misalnya, termostat membaca suhu targetnya dari model data. Class ini menetapkan suhu ruangan ke pengukurannya saat ini, dan mengirimkan data sensor ke Bantuan Mode Di Rumah/Pergi, yang menyesuaikan mode struktur.
Perangkat Nest beroperasi di lingkungan yang terbatas. Daya terbatas dan konektivitas jaringan rumah tidak dapat diandalkan. Produk dan layanan Anda dapat memanfaatkan algoritme perangkat kami untuk menawarkan pengalaman rumah yang intuitif dan sederhana kepada pengguna.
Model data
Nest API ditampilkan sebagai dokumen JSON dengan atribut level teratas
metadata, devices, dan structures. Produk Works with Nest Anda menggunakan dokumen
JSON ini untuk berinteraksi dengan, dan bereaksi terhadap, perangkat Nest dan perubahan status terkait.
Nest structures merepresentasikan struktur fisik di dunia nyata. Berfungsi sebagai titik pengaturan untuk devices dan menyimpan data bangunan secara keseluruhan.
Biasanya, structure adalah beranda pengguna.
Nest devices merepresentasikan perangkat fisik (Termostat, Pelindung, dan Kamera)
dalam struktur.
Setiap elemen data dalam dokumen JSON dapat diberi alamat oleh URL (juga dikenal sebagai "lokasi data"). Berfungsi dengan produk Nest yang dapat membaca dan menulis ke bagian dokumen ini dan berlangganan perubahan. Kemampuan langganan ini memungkinkan produk Works with Nest merespons secara real time terhadap perubahan yang dilakukan pada sistem, seperti mematikan lampu jika pengguna menyetel struktur ke mode Pergi.
Objek juga bekerja di bawah batasan dunia nyata. Model data mengamankan perangkat dan rumah pengguna dengan mencegah tindakan yang mengejutkan dan berbahaya. Misalnya, termostat tidak menjalankan AC saat panas darurat diaktifkan.
Jelajahi model data dengan Referensi API interaktif ini.
Status yang dimaksud
Layanan Nest menyimpan status resmi sistem, dan produk Works with Nest berlangganan perubahan. Memodifikasi status ini (misalnya, untuk mengubah suhu target termostat) menyebabkan layanan mengirimkan notifikasi perubahan ke semua pelanggan.
Karena penerapan ini memiliki beberapa penundaan dan jaringan mungkin tidak dapat diandalkan, status yang diamati oleh produk mungkin bukan status yang saat ini diamati oleh produk atau layanan lain. Status pada akhirnya disinkronkan saat pesan ditransmisikan di antara berbagai produk.
Model publikasi/langganan yang berorientasi pada dokumen ini memberikan interaksi aplikasi yang responsif.
Menggunakan layanan Nest
Untuk mengakses endpoint REST di layanan Nest, gunakan HTTPS di produk Anda. Ada banyak library klien pihak ketiga yang dapat digunakan untuk tujuan ini.
Izin dan otorisasi
Kami ingin mengizinkan developer membuat produk dan layanan yang membuat rumah lebih baik, tanpa mengorbankan privasi dan keamanan pengguna. Semua komunikasi kami aman, dan izin untuk mengakses data selalu diberikan secara eksplisit oleh pengguna. Untuk informasi selengkapnya, lihat Ringkasan Izin.
Otorisasi ditangani oleh protokol OAuth 2.0. Jika pengguna setuju untuk memberikan akses ke tingkat izin yang diminta, Nest akan mengautentikasi permintaan tersebut dan token akses diberikan ke pemohon. Token akses tersebut dapat digunakan untuk mengakses Nest API dan berinteraksi dengan perangkat dan struktur pengguna.
Pemberian token akses akan membangun hubungan kepercayaan antara pengguna, produk Works with Nest, dan Nest. Pengguna dapat mencabut akses kapan saja.
Untuk mempelajari cara mengizinkan koneksi ke Nest API, lihat Ringkasan Otorisasi.