Device Access Project dibatasi oleh batas pengguna, struktur, dan kapasitas, bergantung pada lingkungan dan jenis penawaran Komersial.
Kami ingin developer membuat pengalaman pengguna yang menarik, tetapi kami juga ingin layanan dan perangkat Nest selalu tersedia untuk pengguna. Integrasi yang membuat banyak permintaan dalam jangka waktu tertentu dapat memengaruhi ketersediaan layanan dan perangkat, sehingga SDM API menerapkan batas kapasitas. Pembatasan kapasitas membatasi jumlah panggilan API untuk jangka waktu tertentu dan mencegah penggunaan resource yang berlebihan.
Batas menurut lingkungan
Semua project dimulai di lingkungan Sandbox . Sandbox ditujukan untuk evaluasi SDM API dan penggunaan pribadi, dan batasnya dibatasi sesuai dengan hal tersebut. 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 5 pengguna per struktur, sehingga batas pengguna hanya akan tercapai setelah semua 5 struktur mencapai batas maksimum dengan 5 pengguna per struktur. Akun developer (yang memiliki project) tidak dihitung dalam batas 5 pengguna untuk sebuah struktur.
Sebaliknya, jika sebuah project memiliki 15 pengguna di 5 struktur, pengguna tambahan hanya dapat ditambahkan ke 5 struktur yang ada, karena batas struktur telah tercapai.
Batas kapasitas Sandbox
Sandbox dibatasi kapasitasnya pada 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 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 |
Level perintah
Setiap perintah trait (devices.executeCommand) dibatasi hingga 5 QPM per project, per pengguna, per perangkat.
Artinya, jika sebuah project memiliki 2 pengguna dengan 2 perangkat per pengguna (total 4 perangkat), perintah yang sama dapat dipanggil 5 kali dalam satu menit untuk setiap 4 perangkat tersebut.
Namun, jika sebuah project memiliki 2 pengguna dengan 3 perangkat per pengguna 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, sedangkan batas kapasitas level API devices.executeCommand untuk pengguna project adalah 10 QPM.
Level instance perangkat
Selain itu, batas level instance perangkat diterapkan di seluruh project dan perintah (devices.executeCommand) untuk perlindungan baterai perangkat. Batas ini diterapkan pada level 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 mengotorisasi dua integrasi komersial yang berbeda yang menggunakan perangkat yang sama). Jika Project A telah mengirim 4 perintah ke Perangkat A dalam satu menit, Project B hanya dapat mengirim 1 perintah ke Perangkat A dalam satu menit yang sama sebelum batas kapasitas level instance perangkat tercapai. Pada saat itu, perintah dari kedua Project ke Perangkat A akan dibatasi 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 level 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 terkait dengan panduan ini:
| Pesan Error | RPC | Pemecahan masalah |
|---|---|---|
| Kapasitas terbatas. | RESOURCE_EXHAUSTED |
Setiap developer memiliki kuota yang membatasi jumlah panggilan yang dapat mereka lakukan. Jika Anda melakukan lebih banyak panggilan daripada kuota Anda, Anda akan menerima pesan Kapasitas terbatas. Untuk memperbaikinya, kirim ulang panggilan setelah kuota berakhir. |
Lihat API Error Code Reference untuk mengetahui daftar lengkap kode error API.