REST é um padrão de serviço da Web leve e sem estado que pode ser usado em seus produtos para chamadas únicas, laboratórios de prova de conceito, solução de problemas, apps que pesquisam a cada minuto e atualizações de botões de atualização.
A interface REST usa o URL do modelo de dados da API Nest como um endpoint.
Em REST, há um token OAuth mapeado para um caminho no modelo de dados da API. Cada token está associado a um único usuário final. O token significa que o usuário autorizou o desenvolvedor a acessar um caminho no modelo de dados. A nuvem da API Nest avalia o token em relação ao caminho solicitado e envia um erro ou envia as informações solicitadas.
Suponha que um usuário queira fornecer informações de status sobre a ocupação da casa para que a porta da garagem abra quando o usuário chegar em casa. Um token é avaliado para chegar ao estado "Em casa" e "Ausente" da estrutura.
Para ficar atualizado sobre o estado de ocupação, as chamadas REST podem ser feitas a cada minuto para determinar o status "em casa" ou "ausente". A API Nest avalia o token e retorna a resposta. Em resposta a cada chamada, as informações são retornadas e a conexão TCP é encerrada. Cada chamada gera uma nova conexão TCP.
Lembre-se dos seguintes pontos sobre a implementação do Nest:
- O sufixo
.JSONé opcional para endpoints do URL da Nest - Os produtos precisarão processar redirecionamentos com o código de status 307.
- A limitação de taxa de dados pode ser aplicada aos seus produtos
Não aceitos:
POSTDELETE- Prioridades de gravação para a API REST
- Como gravar valores do servidor com a API REST
- Como recuperar e atualizar regras de segurança
Limites de taxa e REST
Para evitar o uso excessivo do serviço Nest, limitamos o número de tokens com um número limitado de chamadas de leitura/gravação.
Para mais informações, consulte Limites de taxa de dados.
REST e redirecionamentos
Outra consideração ao usar o REST é que o produto também precisa processar redirecionamentos 307.