Device Access los proyectos están restringidos por usuario, estructura y límites de frecuencia, según el entorno y el tipo de oferta comercial.
Queremos que los desarrolladores creen experiencias del usuario atractivas, pero también El servicio y los dispositivos de Nest deben estar siempre disponibles para el usuario. Integraciones que realizar una gran cantidad de solicitudes en un período determinado puede afectar la disponibilidad del dispositivo, por lo que la API de SDM aplica límites de frecuencia. El límite de frecuencia restringe la cantidad de llamadas a la API durante un período determinado evita la utilización excesiva de los recursos.
Límites por entorno
Todos los proyectos comienzan en el entorno Sandbox . La zona de pruebas es destinado a la evaluación de la API de SDM y para uso personal límites se restringen en consecuencia. Entornos con bases de usuarios más grandes, como Desarrollo Comercial , tienen límites diferentes.
Límites de usuarios de la zona de pruebas
Una cuenta de desarrollador en la zona de pruebas está limitada a 25 usuarios de 5 estructuras en todos los proyectos. Existe un límite de 3 proyectos por cuenta.
Cada una tiene un límite de 5 usuarios, por lo que solo se alcanzará el límite de usuarios. una vez que se llegue al máximo de las 5 estructuras, con 5 usuarios cada una. La cuenta de desarrollador (quien es propietario del proyecto) no se considera dentro del límite de 5 usuarios de una en la nube.
Por el contrario, si un proyecto tiene 15 usuarios en 5 estructuras, se pueden agregar más usuarios solo se agregará a las 5 estructuras existentes, ya que el límite de la estructura tiene ya se llegó.
Límites de frecuencia de la zona de pruebas
La zona de pruebas tiene un límite de frecuencia en 3 niveles diferentes. Los límites se establecen en las consultas por minuto (QPM), a menos que se indique lo contrario.
Nivel de API
Las llamadas a la API están limitadas por proyecto y por usuario. Consulta la página Referencia con más información sobre la persona física .
| Método de API | Límite de frecuencia |
|---|---|
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 |
Nivel de comando
Cada comando de trait (devices.executeCommand) tiene un límite de 5 QPM por proyecto,
por usuario y por dispositivo.
Esto significa que, si un proyecto tiene 2 usuarios con 2 dispositivos cada uno (4 dispositivos en total), el se puede llamar al mismo comando 5 veces en un minuto para cada uno de esos 4 dispositivos.
Sin embargo, si un proyecto tiene 2 usuarios con 3 dispositivos cada uno para un total de 6 dispositivos, la
no se pudo llamar al mismo comando 5 veces en un minuto para cada una de esas
dispositivos. Esto generaría 15 QPM para cada usuario, cuando
El límite de frecuencia del nivel de API devices.executeCommand para un usuario del proyecto es de 10 QPM.
Nivel de instancia del dispositivo
Además, los límites de nivel de instancia de dispositivo se implementan en proyectos y
comandos (devices.executeCommand) para proteger la batería del dispositivo. Estos límites
se aplican a nivel de QPM y de consultas por hora (QPH), y no se aplican
a los métodos de la API get y list.
Por ejemplo, supongamos que el Proyecto A y el Proyecto B tienen acceso al mismo dispositivo, dispositivo A (quizás el usuario autorizó dos anuncios comerciales diferentes, integraciones que usan el mismo dispositivo). Si el Proyecto A envió 4 comandos a Al dispositivo A en un minuto, el Proyecto B solo podrá enviar 1 comando al dispositivo A en ese mismo minuto antes de que se alcance el límite de frecuencia de nivel de instancia del dispositivo. En ese momento los comandos de ambos Proyectos al Dispositivo A se regulan hasta el final del el minuto que comenzó con el primer comando al dispositivo A.
Si un tipo de dispositivo no aparece en la siguiente lista, significa que no tiene un nivel de instancia de dispositivo. límites de frecuencia.
| Tipo de dispositivo | Límite de frecuencia de instancias del dispositivo |
|---|---|
| TERMOSTATO | 5 QPM o 100 QPH |
| CÁMARA | 30 QPM o 100 QPH |
| DOORBELL | 30 QPM o 100 QPH |
Errores
Es posible que se muestren los siguientes códigos de error en relación con esta guía:
| Mensaje de error | RPC | Soluciona problemas |
|---|---|---|
| Se limitó la tasa. | RESOURCE_EXHAUSTED |
Cada desarrollador tiene una cuota que limita la cantidad de llamadas que puede hacer. Si realizas más llamadas que las que permites la cuota, recibirás el mensaje de tasa limitada. Para solucionar este problema, vuelve a enviar la llamada una vez que haya vencido la cuota. |
Consulta la referencia de códigos de error de API para la lista completa de códigos de error de API.