Device Access projetos são restritos por usuário, estrutura e limites de taxa, dependendo do ambiente e do tipo de oferta comercial.
Queremos que os desenvolvedores criem experiências de usuário atraentes, mas também que O serviço e os dispositivos Nest precisam estar sempre disponíveis para o usuário. Integrações que fazer um grande número de solicitações em um determinado período pode afetar o serviço e a disponibilidade do dispositivo, para que a API SDM aplique limites de taxa. A limitação de taxa restringe o número de chamadas de API em um determinado período, e e evita a utilização excessiva dos recursos.
Limites por ambiente
Todos os projetos começam no ambiente Sandbox . O sandbox é destinada à avaliação da API SDM e ao uso pessoal e são restritos adequadamente. 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, então o limite de usuários só é atingido quando todas as cinco estruturas tiverem até cinco usuários cada. A conta de desenvolvedor (proprietário do projeto) não conta para o limite de cinco usuários por um na estrutura dos preços.
Por outro lado, se um projeto tiver 15 usuários em 5 estruturas, usuários adicionais podem só podem ser adicionados às cinco estruturas atuais, já que o limite da estrutura tem já tenham sido alcançados.
Limites de taxa do sandbox
O sandbox tem taxa limitada em três níveis diferentes. Os limites são definidos em consultas por minuto (QPM), salvo indicação em contrário.
Nível da API
As chamadas de API são limitadas por projeto e por usuário. Consulte a API Referência para mais informações sobre dados métodos.
| 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) está limitado a 5 QPM por projeto.
por usuário e por dispositivo.
Isso significa que, se um projeto tiver dois usuários com dois dispositivos cada (quatro dispositivos no total), o o mesmo comando pode 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
o mesmo comando não pode ser chamado cinco vezes em um minuto para cada uma das seis
dispositivos. Isso resultaria em 15 QPM para cada usuário, quando o
devices.executeCommand O limite de taxa no nível da API para o usuário de um projeto é de 10 QPM.
Nível da instância do dispositivo
Além disso, limites de instância de dispositivo são implementados em todos os projetos e
(devices.executeCommand) para proteção da bateria do dispositivo. Esses limites
são aplicadas nos níveis de QPM e de consultas por hora (QPH, na sigla em inglês) e não se aplicam
aos métodos de API get e list.
Por exemplo, suponha que o Projeto A e o Projeto B tenham acesso ao mesmo dispositivo A (talvez o usuário tenha autorizado duas plataformas integrações que usam o mesmo dispositivo). Se o Projeto A enviou quatro comandos para dispositivo A em um minuto, o Projeto B só poderá enviar um comando para o Dispositivo A em no mesmo minuto antes de o limite de taxa no nível da instância do dispositivo ser atingido. Com isso os comandos dos Projetos para o Dispositivo A são limitados até o fim do o minuto que começou com o primeiro comando para o dispositivo A.
Se um tipo de dispositivo não está listado abaixo, ele não tem o nível de instância do dispositivo limites de taxa de utilização.
| Tipo de dispositivo | Limite de taxa de instâncias de dispositivos |
|---|---|
| TERMOSTATO | 5 QPM ou 100 QPH |
| CÂMERA | 30 QPM ou 100 QPH |
| DOORBELL | 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 podem ser feitas. Se você fizer mais chamadas do que sua cota, receberá a mensagem de Taxa limitada. Para corrigir isso, reenvie a chamada depois que a cota expirar. |
Consulte a Referência do código de erro da API para a lista completa de códigos de erro da API.