Device Access project dibatasi oleh pengguna, struktur, dan batas kapasitas, bergantung pada lingkungan dan jenis penawaran Komersial.
Kami ingin developer menciptakan pengalaman pengguna yang menarik, tetapi kami juga ingin layanan dan perangkat Nest selalu tersedia bagi pengguna. Integrasi yang membuat permintaan dalam jumlah besar dalam jangka waktu tertentu dapat memengaruhi ketersediaan layanan dan perangkat, sehingga SDM API menerapkan batas kapasitas. Pembatasan kapasitas membatasi jumlah panggilan API selama jangka waktu tertentu dan mencegah penggunaan resource secara berlebihan.
Batas menurut lingkungan
Semua project dimulai di lingkungan Sandbox . Sandbox ditujukan untuk evaluasi SDM API dan penggunaan pribadi, dan batasnya dibatasi. Lingkungan dengan basis pengguna yang lebih besar, seperti Pengembangan Komersial , memiliki batas yang berbeda.
Batas pengguna sandbox
Akun developer di Sandbox dibatasi hingga 25 pengguna di 5 struktur di semua project. Ada batas 3 project per akun.
Struktur dibatasi hingga masing-masing 5 pengguna, sehingga batas pengguna hanya akan tercapai setelah kelima struktur maksimal masing-masing terdiri dari 5 pengguna. Akun developer (yang memiliki project) tidak diperhitungkan dalam batas 5 pengguna untuk struktur.
Sebaliknya, jika project memiliki 15 pengguna di lebih dari 5 struktur, pengguna tambahan hanya dapat ditambahkan ke 5 struktur yang ada, karena batas struktur telah tercapai.
Batas kapasitas sandbox
Sandbox dibatasi kapasitasnya di 3 tingkat yang berbeda. Batas ditetapkan pada kueri per menit (QPM) kecuali jika dinyatakan lain.
Level API
Panggilan API dibatasi per project, per pengguna. Lihat Referensi API untuk mengetahui informasi selengkapnya tentang setiap metode.
| Metode API | Batas Kapasitas |
|---|---|
devices.executeCommand |
10 QPM |
devices.get |
10 QPM |
devices.list |
5 QPM |
structures.get |
5 QPM |
structures.list |
5 QPM |
structures.rooms.get |
5 QPM |
structures.rooms.list |
5 QPM |
Tingkat perintah
Setiap perintah fitur (devices.executeCommand) dibatasi hingga 5 QPM per project,
per pengguna, per perangkat.
Artinya, jika project memiliki 2 pengguna dengan masing-masing 2 perangkat (total 4 perangkat), perintah yang sama dapat dipanggil 5 kali dalam satu menit untuk setiap 4 perangkat tersebut.
Namun, jika project memiliki 2 pengguna dengan masing-masing 3 perangkat untuk total 6 perangkat, perintah yang sama tidak dapat dipanggil 5 kali dalam satu menit untuk setiap 6 perangkat tersebut. Hal ini akan menghasilkan 15 QPM untuk setiap pengguna, jika
batas kapasitas API level devices.executeCommand untuk pengguna project adalah 10 QPM.
Tingkat instance perangkat
Selain itu, batas tingkat instance perangkat diterapkan di seluruh project dan
perintah (devices.executeCommand) untuk perlindungan baterai perangkat. Batasan ini diterapkan pada tingkat QPM dan kueri per jam (QPH) dan tidak berlaku untuk metode API get dan list.
Misalnya, Project A dan Project B memiliki akses ke perangkat yang sama, Perangkat A (mungkin pengguna telah memberikan otorisasi ke dua integrasi komersial yang berbeda yang menggunakan perangkat yang sama). Jika Project A telah mengirimkan 4 perintah ke Perangkat A dalam waktu satu menit, Project B hanya dapat mengirim 1 perintah ke Perangkat A dalam menit yang sama tersebut sebelum batas kapasitas level instance perangkat tercapai. Pada tahap ini, perintah dari kedua Project ke Perangkat A akan di-throttle hingga akhir menit yang dimulai dengan perintah pertama ke Perangkat A.
Jika jenis perangkat tidak tercantum di bawah, jenis perangkat tersebut tidak memiliki batas kapasitas tingkat instance perangkat.
| Jenis Perangkat | Batas Kapasitas Instance Perangkat |
|---|---|
| TERMOSTAT | 5 QPM atau 100 QPH |
| KAMERA | 30 QPM atau 100 QPH |
| DOORBELL | 30 QPM atau 100 QPH |
Error
Kode error berikut dapat ditampilkan sehubungan dengan panduan ini:
| Pesan Error | PPK | Pemecahan masalah |
|---|---|---|
| Kapasitas dibatasi. | RESOURCE_EXHAUSTED |
Setiap developer memiliki kuota yang membatasi jumlah panggilan yang dapat dilakukan. Jika melakukan lebih banyak panggilan daripada kuota, Anda akan menerima pesan Batas kapasitas. Untuk memperbaikinya, kirim ulang panggilan setelah kuota habis masa berlakunya. |
Lihat Referensi Kode Error API untuk mengetahui daftar lengkap kode error API.