Device Access os projetos são restritos por usuários, estrutura e limites de taxas, dependendo do ambiente e do tipo de oferta comercial.
Queremos que os desenvolvedores criem experiências do usuário atraentes, mas também queremos que o serviço e os dispositivos Nest estejam sempre disponíveis para os usuários. Integrações que fazem um grande número de solicitações em um determinado período podem afetar a disponibilidade do serviço e do dispositivo. Portanto, a API SDM aplica limites de taxa. A limitação de taxa restringe o número de chamadas de API por um determinado período e impede a superutilização de recursos.
Limites por ambiente
Todos os projetos começam no ambiente Sandbox . O sandbox é destinado à avaliação da API SDM e ao uso pessoal, e os limites são restritos de acordo. Ambientes com bases de usuários maiores, como Desenvolvimento comercial , têm limites diferentes.
Limites de usuários do sandbox
Uma conta de desenvolvedor no sandbox é limitada a 25 usuários em cinco estruturas em todos os projetos. Há um limite de três projetos por conta.
As estruturas são limitadas a cinco usuários cada. Portanto, o limite de usuários só será atingido quando as cinco estruturas forem atingidas com cinco usuários cada. A conta de desenvolvedor (que é proprietária do projeto) não conta para o limite de cinco usuários para uma estrutura.
Por outro lado, se um projeto tiver 15 usuários em 5 estruturas, outros usuários só poderão ser adicionados às 5 estruturas existentes, já que o limite já foi atingido.
Limites de taxa de sandbox
O sandbox tem limitação de taxa em três níveis diferentes. Os limites são definidos em consultas por minuto (QPM), a menos que indicado de outra forma.
Nível da API
As chamadas de API são limitadas por projeto e por usuário. Consulte a Referência da API para mais informações sobre métodos individuais.
Método de API | Limite de taxa |
---|---|
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 |
Nível de comando
Cada comando de característica (devices.executeCommand
) é limitado a 5 QPM por projeto,
usuário e dispositivo.
Isso significa que, se um projeto tiver dois usuários com dois dispositivos cada (quatro dispositivos no total), o mesmo comando poderá ser chamado cinco vezes em um minuto para cada um desses quatro dispositivos.
No entanto, se um projeto tiver dois usuários com três dispositivos cada para seis dispositivos no total, o
mesmo comando não poderá ser chamado cinco vezes em um minuto para cada um desses seis
dispositivos. Isso resultaria em 15 QPM para cada usuário quando o
limite de taxa no nível da API devices.executeCommand
para um usuário de um projeto for de 10 QPM.
Nível da instância do dispositivo
Além disso, os limites no nível da instância do dispositivo são implementados em projetos e
comandos (devices.executeCommand
) para proteção da bateria do dispositivo. Esses limites são aplicados nos níveis de QPM e de consultas por hora (QPH, na sigla em inglês) e não aos métodos de API get
e list
.
Por exemplo, suponha que o Projeto A e o Projeto B tenham acesso ao mesmo dispositivo, Dispositivo A, talvez o usuário tenha autorizado duas integrações comerciais diferentes que usam o mesmo dispositivo. Se o Projeto A enviar quatro comandos para o Dispositivo A em um minuto, o Projeto B só poderá enviar um comando para o Dispositivo A nesse mesmo minuto antes que o limite de taxa no nível da instância do dispositivo seja atingido. Nesse ponto, os comandos dos dois projetos para o Dispositivo A são limitados até o final do minuto iniciado com o primeiro comando para o Dispositivo A.
Se um tipo de dispositivo não estiver listado abaixo, ele não tem limites de taxa no nível da instância do dispositivo.
Tipo de dispositivo | Limite de taxa de instância do dispositivo |
---|---|
TERMOSTATO | 5 QPM ou 100 QPH |
CÂMERA | 30 QPM ou 100 QPH |
CAMPAINHA | 30 QPM ou 100 QPH |
Erros
Os seguintes códigos de erro podem ser retornados em relação a este guia:
Mensagem de erro | RPC | Solução de problemas |
---|---|---|
Taxa limitada. | RESOURCE_EXHAUSTED |
Cada desenvolvedor tem uma cota que limita o número de chamadas que eles podem fazer. Se fizer mais chamadas do que sua cota, você receberá a mensagem Taxa limitada. Para corrigir isso, reenvie a chamada depois que a cota expirar. |
Consulte a Referência de código de erro da API para ver a lista completa de códigos de erro.