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 yang berlebihan.
Batasan menurut lingkungan
Semua project dimulai di lingkungan Sandbox . Sandbox dimaksudkan untuk evaluasi SDM API dan penggunaan pribadi, dan batasnya dibatasi. Lingkungan dengan basis pengguna yang lebih besar, seperti Commercial Development , memiliki batas yang berbeda.
Batas pengguna sandbox
Akun developer di Sandbox dibatasi untuk 25 pengguna di 5 struktur di semua project. Ada batasan 3 project per akun.
Struktur dibatasi hingga 5 pengguna masing-masing, sehingga batas pengguna hanya akan tercapai setelah 5 struktur masing-masing berisi 5 pengguna maksimal. Akun developer (yang memiliki project) tidak diperhitungkan dalam batas 5 pengguna untuk suatu struktur.
Sebaliknya, jika sebuah project memiliki 15 pengguna di atas 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 level 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 metode individual.
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 karakteristik (devices.executeCommand
) dibatasi hingga 5 QPM per project, per pengguna, per perangkat.
Artinya, jika sebuah project memiliki 2 pengguna yang masing-masing memiliki 2 perangkat (total 4 perangkat), perintah yang sama dapat dipanggil 5 kali dalam satu menit untuk masing-masing dari keempat perangkat tersebut.
Namun, jika project memiliki 2 pengguna dengan masing-masing 3 perangkat untuk 6 perangkat, perintah yang sama tidak dapat dipanggil 5 kali dalam satu menit untuk masing-masing
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 level instance perangkat diterapkan di seluruh project dan
perintah (devices.executeCommand
) untuk perlindungan baterai perangkat. Batas ini diterapkan di tingkat QPM dan kueri per jam (QPH) serta 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 mengizinkan dua integrasi komersial yang berbeda yang menggunakan perangkat yang sama). Jika Project A telah mengirimkan 4 perintah ke Perangkat A dalam satu menit, maka Project B hanya dapat mengirimkan 1 perintah ke Perangkat A pada menit yang sama sebelum mencapai batas kapasitas tingkat instance perangkat. Pada tahap tersebut, perintah dari kedua Project ke Perangkat A dibatasi hingga akhir menit yang dimulai dengan perintah pertama ke Perangkat A.
Jika jenis perangkat tidak tercantum di bawah ini, jenis perangkat tersebut tidak memiliki batas kapasitas tingkat instance perangkat.
Device Type | Batas Kapasitas Instance Perangkat |
---|---|
TERmostat | 5 QPM atau 100 QPH |
KAMERA | 30 QPM atau 100 QPH |
BEL PINTU | 30 QPM atau 100 QPH |
Error
Kode error berikut mungkin ditampilkan terkait dengan panduan ini:
Pesan Error | RPC | Pemecahan masalah |
---|---|---|
Kapasitas dibatasi. | RESOURCE_EXHAUSTED |
Setiap developer memiliki kuota yang membatasi jumlah panggilan yang dapat mereka lakukan. Jika melakukan panggilan melebihi kuota, Anda akan menerima pesan Tarif dibatasi. Untuk memperbaikinya, kirim ulang panggilan setelah kuota berakhir. |
Baca Referensi Kode Error API untuk mengetahui daftar lengkap kode error API.