ProjectDevice Access 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 banyak permintaan dalam jangka waktu tertentu dapat memengaruhi ketersediaan layanan dan perangkat, sehingga SDM API menerapkan batas kecepatan. Pembatasan kapasitas membatasi jumlah panggilan API untuk jangka waktu tertentu dan mencegah penggunaan sumber daya 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 itu. 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 maksimal 5 pengguna per struktur. 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 frekuensi sandbox
Sandbox memiliki batasan kapasitas di 3 tingkat yang berbeda. Batas ditetapkan pada kueri per menit (QPM) kecuali 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 karakteristik (devices.executeCommand) dibatasi hingga 5 QPM per project,
per pengguna, per perangkat.
Artinya, jika sebuah 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 sebuah project memiliki 2 pengguna dengan masing-masing 3 perangkat, sehingga totalnya 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, padahal batas kecepatan level API 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. Batas ini diterapkan di 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, yaitu Perangkat A (mungkin pengguna telah mengizinkan dua integrasi komersial berbeda yang menggunakan perangkat yang sama). Jika Project A telah mengirim 4 perintah ke Perangkat A dalam satu menit, maka Project B hanya dapat mengirim 1 perintah ke Perangkat A dalam menit yang sama sebelum batas frekuensi tingkat 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, berarti tidak memiliki batas laju tingkat instance perangkat.
| Jenis Perangkat | Batas Kecepatan Instance Perangkat |
|---|---|
| THERMOSTAT | 5 QPM atau 100 QPH |
| KAMERA | 30 QPM atau 100 QPH |
| BEL PINTU | 30 QPM atau 100 QPH |
Error
Kode error berikut dapat ditampilkan terkait panduan ini:
| Pesan Error | PPK | 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 akan menerima pesan Rate limited. Untuk memperbaiki hal ini, kirim ulang panggilan setelah kuota berakhir. |
Lihat Referensi Kode Error API untuk mengetahui daftar lengkap kode error API.